microbit-foundation / dev-docs

The content of the tech.microbit.org site
https://tech.microbit.org
Other
56 stars 70 forks source link

Re-phrase making-accessories to be more direct #205

Closed Gadgetoid closed 3 years ago

Gadgetoid commented 3 years ago

The "Making Accessories" page suffers from a case of the waffles;

I have attempted to reword this page to be more direct, making truthful statements that are useful to a PCB designer and avoiding unquantifiable, fluffy statements.

One key thing that's missing from documentation around the Edge Connector (unless I missed it) is any direct link to a suitable connector part. Is there a particular reason why the Foundation is not linking to suppliers? Is there a preferred supplier that could be linked to?

Hosting and linking to a datasheet for a compatible part might be a good compromise if all else fails. EG: Here's 4ucon's connector I found on Coolcomponents - http://www.4uconnector.com/online/object/4udrawing/10156.pdf

microbit-mark commented 3 years ago

Looks good. We have links to edge connectors on https://github.com/microbit-foundation/dev-docs/commit/c72e636b814c7741ee8e5f28e8aa785d31ef7b36 including the 4uCon connector. There is also a submission button that takes you to GitHub to edit the page and add your connections. Perhaps we could reference the edge connector page and the examples better on this page.

microbit-mark commented 3 years ago

Merging as the page update is good