Pico Pinout Project Outline & Goals

Gadgetoid commented 2 years ago

Preview the work-in-progress here: https://pico.pinout.xyz/

Mission Statement

To make an accessible alternative to the static, graphical Raspberry Pi Pico pinout.

Must:

Be easy for beginners to read/filter/facet
Be at least somewhat compatible with screen readers (help, I don't know what I'm doing!)
Make some accommodations for colour impaired users.
Be simple, straight-forward but visually beautiful

Roadmap

[x] Replaced hot-linked Pi image with a lovely scalable SVG
[x] Alt-text! - "Your Raspberry Pi Pico, orientated with the USB port facing upwards and sitting on its little pin legs."
[ ] Figure out aria labelling to introduce each pin as "GP0, first pin down on the left-hand side"
[ ] Add expansion boards somehow. Might need to write a tool to generate the pinout HTML... hand-crafting could get very tiresome!

How you can help

Hit "Sponsor". No. Really. :laughing:
Lend your expertise- are there better ways to lay this out semantically, support screen readers, etc?
Just try it out and see how it works for you! - https://pico.pinout.xyz/

justin-pierce commented 1 year ago

Don't see a license -- are you ok with derivatives etc?

Gadgetoid commented 1 year ago

Ooh that's a good point. I placed Pinout.xyz under CC-BY-NC mostly because I didn't want to encourage lousy hackjobs and straight up screenshots, but that all seemed to happen regardless. Additionally the non-commercial clause prevented contributions by employees of certain orgs who were unable to work with those terms for nebulous legal reasons.

I guess CC-BY-SA is probably most reflective of what I want people to do with this stuff.

pinout-xyz / pico.pinout.xyz