Effective Software Documentation with Everett Griffiths - EMx 180
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.
Special Guests:
Everett Griffiths
Show Notes
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
Picks
Effective Software Documentation with Everett Griffiths - EMx 180
0:00
Playback Speed: