Elixir Mix is a weekly show focused on the Elixir programming community. Our panel discusses topics around functional programming, the Elixir ecosystem, and building real world apps with Elixir based tools and frameworks.
Effective Software Documentation with Everett Griffiths - EMx 180
July 06, 2022
1:01:13
74.4 MB
Downloads: 0
Bad documentation wastes time, costs real money, and makes developers unproductive. Documentation might be bad because it is flat-out wrong (typos, references to an older version, etc.), but more often documentation is bad when it fails to tell us what we need to know. Don’t let all your hard work go to waste because you failed to communicate what your software is or how to use it. Today on the show, Everett Griffiths shares his insights on how to approach documentation simply and effectively.
In this episode…
- What got you into documentation?
- Examples, examples, examples
- Having an effective feedback loop
- Key word arguments
- Coding is easy, but documentation is hard
- Using mermaid charts
- Open sourcing your software
- Clean code and clean infrastructure
- Simplifying coding environments
Sponsors
Links
- WTFM: Writing Effective Software Documentation
- Inspecting Ecto Schemas with Elixir | by Everett Griffiths | Medium 1
- Enhancing Elixir Documentation with Mermaid Charts | by Everett Griffiths | Medium 1
- Coding is Easy; Communication is Hard | by Everett Griffiths | Medium 1
- LinkedIn: Everett Griffiths
- Twitter: @fireproofsocks