Date: Mon, 23 Aug 2021 07:00:00 -0000
<p>It’s easy to overlook documentation when building an application, but documentation can make or break a consumer’s experience. Today we’re diving into the world of documentation to discuss what it takes to write good documentation, the ethics of documentation, and some popular tools you can use to get started.</p> <h1>Show Notes</h1> <ul> <li>[01:58] Why does a company or app need good documentation?</li> <li>[04:09] Who do we write documentation for?</li> <li>[06:01] What makes good documentation?</li> <li>[11:05] Ethics of documentation</li> <li>[32:47] The structure of your documentation</li> <li>[34:35] What types of documentation should I write?</li> <li>[40:22] Documentation tools</li> <li>[44:51] Shoutouts</li> </ul> <h1>Resources</h1> <ul> <li><a href="https://alexjs.com/" rel="nofollow">Alex.js</a></li> <li><a href="https://www.youtube.com/watch?v=BKf3oGfgLwk" rel="nofollow">Carolyn’s talk</a></li> <li><a href="https://www.selfdefined.app/" rel="nofollow">Self Defined</a></li> <li><a href="https://hemingwayapp.com/" rel="nofollow">Hemingway</a></li> <li><a href="https://www.bookstackapp.com/" rel="nofollow">Bookstack</a></li> <li><a href="https://storybook.js.org/" rel="nofollow">Storybook</a></li> <li><a href="https://www.youtube.com/watch?v=a4L9GhldTHo" rel="nofollow">Writing Technical Documentation video</a></li> <li><a href="https://www.notion.so/" rel="nofollow">Notion</a></li> <li><a href="https://www.nuclino.com/" rel="nofollow">Nuclino</a></li> <li><a href="https://docusaurus.io/" rel="nofollow">Docusaurus</a></li> <li><a href="https://nextjs.org/" rel="nofollow">Next.js</a></li> <li><a href="https://nuxtjs.org/" rel="nofollow">Nuxt.js</a></li> <li><a href="https://www.gatsbyjs.com/" rel="nofollow">Gatsby</a></li> <li><a href="https://jekyllrb.com/" rel="nofollow">Jekyll</a></li> </ul> <h1>Transcript</h1> <p>Here is <a href="https://drive.google.com/file/d/148S7kAuXZ8uurUAga-oFrqKF5pjOCnFf/view?usp=sharing" rel="nofollow">this week's transcript</a>.</p>
