Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(docs): Add New Behavior Guide #1268

Merged
merged 6 commits into from May 21, 2022
Merged

Conversation

kurtis-lew
Copy link
Contributor

@kurtis-lew kurtis-lew commented Apr 25, 2022

Co-Authored-By: Henré Botha henrebotha@gmail.com
Co-Authored-By: Cem Aksoylar caksoylar@users.noreply.github.com
Co-Authored-By: Dom H dom@hxy.io

This PR adds a guide for developers wishing to create new behaviors for ZMK. The behavior guide is largely inspired by the new shield guide, and shows users how to:

  • Create the behavior
  • Test changes locally
  • Document behavior functionality
  • Create a Pull Request for review and inclusion into the ZMK sources

Co-Authored-By: Henré Botha <henrebotha@gmail.com>
Co-Authored-By: Cem Aksoylar <caksoylar@users.noreply.github.com>
Co-Authored-By: Dom H <dom@hxy.io>

LOG_MODULE_DECLARE(zmk, CONFIG_ZMK_LOG_LEVEL);

#if DT_HAS_COMPAT_STATUS_OKAY(DT_DRV_COMPAT)
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Planning to rewrite this section given the review done by @joelspadin in #1275.
#1275 (comment)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Leave it for a separate MR maybe? I think it would be good to just get this merged and then follow up.

Copy link
Collaborator

@dxmh dxmh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome guide – looks great to me from a docs point of view!

As mentioned in #1174 (review), I think it would be good to get approval from at least one developer contributor familiar with the more technical aspects. Maybe @petejohanson, @joelspadin or @okke-formsma could take a glance over this and give a thumbs up before we merge?

docs/docs/development/new-behavior.md Outdated Show resolved Hide resolved
@dxmh dxmh added documentation Improvements or additions to documentation enhancement New feature or request behaviors labels May 3, 2022
- Address Event Manager review comments by @okke-formsma
- Update PR section to link to contributor documentation
Copy link
Contributor

@petejohanson petejohanson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a couple minor things. On a whole this is AWESOME.

docs/docs/development/new-behavior.md Outdated Show resolved Hide resolved
docs/docs/development/new-behavior.md Show resolved Hide resolved
@kurtis-lew kurtis-lew force-pushed the behavior_guide branch 3 times, most recently from f9747f2 to 71f6c67 Compare May 17, 2022 22:39
- Update hardware testing section
- Add note to update app/dts/behaviors.dtsi

Co-Authored-By: Pete Johanson <peter@peterjohanson.com>
Copy link
Contributor

@petejohanson petejohanson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just one other thing I noticed.

docs/docs/development/new-behavior.md Show resolved Hide resolved
@kurtis-lew kurtis-lew changed the title feat(docs) Add New Behavior Guide feat(docs): Add New Behavior Guide May 18, 2022
Copy link
Contributor

@petejohanson petejohanson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is awesome. @dxmh or @caksoylar can weight in/approve and merge when they're ready.

@netlify
Copy link

netlify bot commented May 19, 2022

👷 Deploy request for zmk accepted.

Name Link
🔨 Latest commit 052c700
🔍 Latest deploy log https://app.netlify.com/sites/zmk/deploys/628666a294355d0009ec031d

Copy link
Collaborator

@dxmh dxmh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am curious if the removal of the inline code formatting (backticks) was intentional in the latest commit, 052c700. But either way, all the recent changes since my last review look great to me. 👍

@dxmh dxmh merged commit 8a70d5f into zmkfirmware:main May 21, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
behaviors documentation Improvements or additions to documentation enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

6 participants