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

docs: Streamlined the new shield guide #2515

Merged
merged 4 commits into from
Sep 30, 2024

Conversation

Nick-Munnich
Copy link
Contributor

This PR builds on #2510 in an attempt to streamline our new shield guide somewhat. I do see some further improvements that can be made, but I think this version reads nicer and eases future improvements. In particular, the future improvements I'd like to see are:

  • Once feat(docs): Added a page on module creation #2456 is merged, replacing the section on module creation with a link to the page created in that PR (with a note on modifying the personal zmk-config for truly personal designs)
  • Making a page on kscans which pulls out the information in the config page (currently a bit of an ugly mix of "how to", "explainer", "reference") and referring to that more directly
  • Making a page on matrix transformations and referring to that
  • Pulling the information on physical transformations out into the relevant zmk-studio page, renaming said page to "Physical Layouts" and referring to that page

I think the above steps are likely required in order to be able to write a nice "New Keyboard Board" guide in the future.

@Nick-Munnich Nick-Munnich requested a review from a team as a code owner September 29, 2024 17:46
@Nick-Munnich Nick-Munnich added the documentation Improvements or additions to documentation label Sep 29, 2024
Copy link
Contributor

@caksoylar caksoylar left a comment

Choose a reason for hiding this comment

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

While I have some notes, I think this page really needed straightening up and this is great overall. Thanks!

As an aside, cosmetically, it'd be nice to have empty lines in some places where tags like <TabItem> are used, e.g. one before open tag and one after close.

docs/docs/development/hardware-integration/new-shield.mdx Outdated Show resolved Hide resolved
docs/docs/development/hardware-integration/new-shield.mdx Outdated Show resolved Hide resolved
docs/docs/development/hardware-integration/new-shield.mdx Outdated Show resolved Hide resolved
docs/docs/development/hardware-integration/new-shield.mdx Outdated Show resolved Hide resolved
docs/docs/development/hardware-integration/new-shield.mdx Outdated Show resolved Hide resolved
docs/docs/development/hardware-integration/new-shield.mdx Outdated Show resolved Hide resolved
docs/docs/development/hardware-integration/new-shield.mdx Outdated Show resolved Hide resolved
docs/docs/development/hardware-integration/new-shield.mdx Outdated Show resolved Hide resolved
docs/docs/development/hardware-integration/new-shield.mdx Outdated Show resolved Hide resolved
Copy link
Contributor Author

@Nick-Munnich Nick-Munnich left a comment

Choose a reason for hiding this comment

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

Added some whitespace and I think resolved all the comments.

Copy link
Contributor

@caksoylar caksoylar left a comment

Choose a reason for hiding this comment

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

LGTM, you can merge once you rebase with the encoder factoring commits.

docs/docs/development/hardware-integration/new-shield.mdx Outdated Show resolved Hide resolved
@caksoylar
Copy link
Contributor

Also, all four points in your future plans sounds good and necessary to me. Thanks again for cleaning up this page!

@Nick-Munnich Nick-Munnich merged commit 99b424b into zmkfirmware:main Sep 30, 2024
7 checks passed
@Nick-Munnich Nick-Munnich deleted the new-shield branch September 30, 2024 22:00
rafaelromao pushed a commit to rafaelromao/zmk that referenced this pull request Oct 8, 2024
* docs: Streamlined the new shield guide

---------

Co-authored-by: Cem Aksoylar <[email protected]>
lammai pushed a commit to lammai/zmk that referenced this pull request Oct 27, 2024
* docs: Streamlined the new shield guide

---------

Co-authored-by: Cem Aksoylar <[email protected]>
EnotionZ pushed a commit to EnotionZ/zmk that referenced this pull request Nov 6, 2024
* docs: Streamlined the new shield guide

---------

Co-authored-by: Cem Aksoylar <[email protected]>
earwin pushed a commit to earwin/zmk that referenced this pull request Nov 13, 2024
* docs: Streamlined the new shield guide

---------

Co-authored-by: Cem Aksoylar <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants