4 ms·
Docs at my company are living docs, a group effort, current, and a joy to read. This is made possible by using Markdown (we use Hugo) and letting everyone at th
by DavidCanHelp 8y ago
Docs at my company are living docs, a group effort, current, and a joy to read. This is made possible by using Markdown (we use Hugo) and letting everyone at the company submit PRs ad hoc, as well as the obvious updates that roll out with new releases. We also write blogs that discuss example code, linking back to the docs, and post that example code on GitHub. To top it all off, I've been building Docker images that allow readers of the docs and blog posts to run example code with a single command and no configuration or installation (provided they have Docker).