What up, docs? 🥕
JS Party: JavaScript, CSS, Web Development
English - November 02, 2018 17:08 - 54 minutes - 75.1 MB - ★★★★★ - 32 ratingsTechnology Education How To jsparty javascript html web programming frontend backend node changelog css Homepage Download Apple Podcasts Google Podcasts Overcast Castro Pocket Casts RSS feed
Safia, Nick, Jerod, and Chris get together to talk about documentation. Documentation is essential in our work but it can be difficult to get buy-in. The crew talks about how you can get others to care about it in your organization, tools that make documentation easier, and some examples of companies doing it right.
Safia, Nick, Jerod, and Chris get together to talk about documentation. Documentation is essential in our work but it can be difficult to get buy-in. The crew talks about how you can get others to care about it in your organization, tools that make documentation easier, and some examples of companies doing it right.
Changelog++ members support our work, get closer to the metal, and make the ads disappear. Join today!
Sponsors:
Gauge – Low maintenance test automation! Gauge is free and open source test automation framework that takes the pain out of acceptance testing.
Rollbar – We catch our errors before our users do because of Rollbar. Resolve errors in minutes, and deploy your code with confidence. Learn more at rollbar.com/changelog.
.TECH domains – There’s a new top level domain to consider when purchasing your next domain for your next big idea. Get your .tech for 90% off when you use code CHANGELOG on get.tech
DigitalOcean – DigitalOcean is simplicity at scale. Whether your business is running one virtual machine or ten thousand, DigitalOcean gets out of your way so your team can build, deploy, and scale faster and more efficiently. New accounts get $100 in credit to use in your first 60 days.
Featuring:
Safia Abdalla – Twitter, GitHub, WebsiteNick Nisi – Twitter, GitHub, WebsiteJerod Santo – Mastodon, Twitter, GitHub, LinkedInChristopher Hiller – Mastodon, Twitter, GitHub, Website
Show Notes:
@kahliltweets on Twitter
Safia loves the React Styleguidist
Read about Literate Programming on Wikipedia
Jeremy Ashkenas’ Literate CoffeeScript
Docco is a tool for literate programming
Stripe’s API docs are 👌
So are Twilio’s
Nick likes Chai’s docs
Jerod mentions UmbrellaJS, everyone is impressed
Dash is 💣 for macOS docs
Maybe Velocity is just as cool for Windows?
In terms of guides, check out Ruby on Rails and GitHub’s Open Source Guides
Something missing or broken? PRs welcome!