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): Generate new shield interconnect docs. #1607

Conversation

petejohanson
Copy link
Contributor

@petejohanson petejohanson commented Dec 23, 2022

  • Add to metadata schema for interconnects.
  • New conventional location for pinout diagrams/pics.
  • New component to generate the tabs for the new shield
    doc section on interconnects.
  • Add XIAO and arduino uno pinout diagram.

@petejohanson petejohanson self-assigned this Dec 23, 2022
@petejohanson petejohanson added documentation Improvements or additions to documentation enhancement New feature or request shields PRs and issues related to shields labels Dec 23, 2022
@petejohanson petejohanson force-pushed the docs/interconnect-new-shield-generated branch 2 times, most recently from 2d05215 to e183987 Compare December 23, 2022 05:18
@petejohanson
Copy link
Contributor Author

Deploy preview page with the new implementation: https://deploy-preview-1607--zmk.netlify.app/docs/development/new-shield#shield-overlays

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.

Looks good to me in general, I had a clarification question and a few subjective wording improvements.

Also it looks like the old blackpill and pro micro pinout assets can be removed; I found only one other reference to them:

diff --git a/docs/docs/assets/blackpill/blackpill-pins-labelled.png b/docs/docs/assets/blackpill/blackpill-pins-labelled.png
deleted file mode 100644
index 3f15c620..00000000
Binary files a/docs/docs/assets/blackpill/blackpill-pins-labelled.png and /dev/null differ
diff --git a/docs/docs/assets/pro-micro/pro-micro-pins-labelled.jpg b/docs/docs/assets/pro-micro/pro-micro-pins-labelled.jpg
deleted file mode 100644
index 88161e39..00000000
Binary files a/docs/docs/assets/pro-micro/pro-micro-pins-labelled.jpg and /dev/null differ
diff --git a/docs/docs/development/boards-shields-keymaps.md b/docs/docs/development/boards-shields-keymaps.md
index 4444537e..4644ee79 100644
--- a/docs/docs/development/boards-shields-keymaps.md
+++ b/docs/docs/development/boards-shields-keymaps.md
@@ -34,7 +34,7 @@ in the `app/boards/${arch}/${board_name}` directory, e.g. `app/boards/arm/planck
 
 ## Pro Micro Compatible Keyboard
 
-![Labelled Pro Micro pins](../assets/pro-micro/pro-micro-pins-labelled.jpg)
+![Labelled Pro Micro pins](../assets/interconnects/pro_micro/pinout.png)
 
 For keyboards that require a (usually Pro Micro compatible) add-on board to operate, the ZMK integration pieces are places
 in the _shield_ definition for that keyboard, allowing users to

app/boards/interconnects/arduino_uno/arduino_uno.zmk.yml Outdated Show resolved Hide resolved
app/boards/interconnects/blackpill/blackpill.zmk.yml Outdated Show resolved Hide resolved
app/boards/interconnects/pro_micro/pro_micro.zmk.yml Outdated Show resolved Hide resolved
app/boards/interconnects/seeed_xiao/seeed_xiao.zmk.yml Outdated Show resolved Hide resolved
@petejohanson petejohanson force-pushed the docs/interconnect-new-shield-generated branch 3 times, most recently from 3f3f732 to 865d7c8 Compare December 23, 2022 06:56
* Add to metadata schema for interconnects.
* New conventional location for pinout diagrams/pics.
* New component to generate the tabs for the new shield
  doc section on interconnects.
* Add XIAO and arduino uno pinout diagram.

Co-authored-by: Cem Aksoylar <caksoylar@users.noreply.github.com>
@petejohanson petejohanson force-pushed the docs/interconnect-new-shield-generated branch from 865d7c8 to b4715db Compare December 23, 2022 06:58
@petejohanson petejohanson merged commit c23443a into zmkfirmware:main Dec 23, 2022
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 enhancement New feature or request shields PRs and issues related to shields
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants