Stay current on JavaScript, Node, and Front-End development. Learn from experts in programming, careers, and technology every week. Become a supporter of this podcast: https://www.spreaker.com/podcast/javascript-jabber--6102064/support.
…
continue reading
Content provided by Charles M Wood. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by Charles M Wood or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://player.fm/legal.
Player FM - Podcast App
Go offline with the Player FM app!
Go offline with the Player FM app!
Effective Software Documentation with Everett Griffiths - EMx 180
MP3•Episode home
Manage episode 333812651 series 2294501
Content provided by Charles M Wood. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by Charles M Wood or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://player.fm/legal.
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…
Sponsors
Links
Picks
Advertising Inquiries: https://redcircle.com/brands
Privacy & Opt-Out: https://redcircle.com/privacy
Become a supporter of this podcast: https://www.spreaker.com/podcast/elixir-mix--6102049/support.
…
continue reading
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
- Adi- Grafana OnCall
- Allen- MJML - The Responsive Email Framework
- Everett- Paasaa - Paasaa v0.6.0
- Everett- The Guns of August: The Pulitzer Prize-Winning Classic About the Outbreak of World War I
Advertising Inquiries: https://redcircle.com/brands
Privacy & Opt-Out: https://redcircle.com/privacy
Become a supporter of this podcast: https://www.spreaker.com/podcast/elixir-mix--6102049/support.
296 episodes
MP3•Episode home
Manage episode 333812651 series 2294501
Content provided by Charles M Wood. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by Charles M Wood or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://player.fm/legal.
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…
Sponsors
Links
Picks
Advertising Inquiries: https://redcircle.com/brands
Privacy & Opt-Out: https://redcircle.com/privacy
Become a supporter of this podcast: https://www.spreaker.com/podcast/elixir-mix--6102049/support.
…
continue reading
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
- Adi- Grafana OnCall
- Allen- MJML - The Responsive Email Framework
- Everett- Paasaa - Paasaa v0.6.0
- Everett- The Guns of August: The Pulitzer Prize-Winning Classic About the Outbreak of World War I
Advertising Inquiries: https://redcircle.com/brands
Privacy & Opt-Out: https://redcircle.com/privacy
Become a supporter of this podcast: https://www.spreaker.com/podcast/elixir-mix--6102049/support.
296 episodes
All episodes
×Welcome to Player FM!
Player FM is scanning the web for high-quality podcasts for you to enjoy right now. It's the best podcast app and works on Android, iPhone, and the web. Signup to sync subscriptions across devices.