Paying it Forward: Documenting your Open Hardware #OpenHardware #OpenSOurce @xobs
Sean “xobs” Cross has an excellent discussion from linux.conf.au on documenting Open Hardware modules (undocumented hardware is bad).
We all know documentation is important, but often times it’s seen as either something to be done before a project starts — in which case it’s often outdated — or after the project is complete — at which point it’s easily forgotten. This problem is especially difficult with hardware projects, which can be extremely obscure and dense.
Professional chips generally come with a reference manual that describes the hardware. This manual is usually created by a dedicated staff that uses publishing tools and spreadsheets to create a final PDF file. As small open source developers we rarely have the resources to create these reference manuals by hand.
This talk covers `lxsocdoc`, and covers how they document the various peripherals inside projects such as Fomu and Betrusted, and provide motivation for treating documentation like code. They show why documenting as you go is both beneficial to end users, as well as beneficial to yourself, and why an approach such as the one taken in `lxsocdoc` can help yourself today, not to mention your future self.
We are angry, frustrated, and in pain because of the violence and murder of Black people by the police because of racism. We are in the fight AGAINST RACISM. George Floyd was murdered, his life stolen. The Adafruit teams have specific actions we’ve done, are doing, and will do together as a company and culture. We are asking the Adafruit community to get involved and share what you are doing. The Adafruit teams will not settle for a hash tag, a Tweet, or an icon change. We will work on real change, and that requires real action and real work together. That is what we will do each day, each month, each year – we will hold ourselves accountable and publish our collective efforts, partnerships, activism, donations, openly and publicly. Our blog and social media platforms will be utilized in actionable ways. Join us and the anti-racist efforts working to end police brutality, reform the criminal justice system, and dismantle the many other forms of systemic racism at work in this country, read more @ adafruit.com/blacklivesmatter
Stop breadboarding and soldering – start making immediately! Adafruit’s Circuit Playground is jam-packed with LEDs, sensors, buttons, alligator clip pads and more. Build projects with Circuit Playground in a few minutes with the drag-and-drop MakeCode programming site, learn computer science using the CS Discoveries class on code.org, jump into CircuitPython to learn Python and hardware together, TinyGO, or even use the Arduino IDE. Circuit Playground Express is the newest and best Circuit Playground board, with support for CircuitPython, MakeCode, and Arduino. It has a powerful processor, 10 NeoPixels, mini speaker, InfraRed receive and transmit, two buttons, a switch, 14 alligator clip pads, and lots of sensors: capacitive touch, IR proximity, temperature, light, motion and sound. A whole wide world of electronics and coding is waiting for you, and it fits in the palm of your hand.