Verbs Not Nouns: Writing Effective Documentation with Brian MacDonald
The Business of Open Source
English - December 28, 2022 08:30 - 28 minutes - 41.6 MB - ★★★★ - 3 ratingsTechnology Business Entrepreneurship open source open source startup founder stories business end user stories real world Homepage Download Apple Podcasts Google Podcasts Overcast Castro Pocket Casts RSS feed
Previous Episode: Developing Commercial Open Source Companies with Joseph Jacks
Brian MacDonald, Manager of Technical Editing at DigitalOcean joins me to discuss the importance of writing efficient documentation for any product.
In this episode, Brian and I chat about his talk at All Things Open entitled Verbs Not Nouns and covering the importance of writing documentation that instructs your users on how to use your product to solve the problem it intends to solve for them. We also cover common mistakes in writing documentation and tips for ensuring yours is effective. Listen to hear Brian's advice and resources to improve your documentation.
Highlights:
Links:
Brian
LinkedIn: https://www.linkedin.com/in/macdonaldeditorial/Twitter: https://twitter.com/bmac_editorCompany: https://www.digitalocean.com/Resources: Verbs Not Nouns Slides: https://archive.org/details/verbs-not-nouns-ato-2022Write The Docs Community: https://www.writethedocs.org/