Technical writing with Continuous Integration and docs-as-code
What does it take to put together a website, a book, an ebook, all for sale online? Let’s look at costs for tools and services that make it happen. Let’s look at what you need for a book idea. You need an audience, an editor, a way to reach that audience, and a “pitch” for […]
When using docs-as-code techniques, writers might hesitate to work with others on content deliverables, and developers might feel they have little to contribute to the documentation. I assert is that no one can know everything, so distribute the workload by writing together just like you collaborate together on code. What about reviews? How do you maintain quality while working […]
An article I wrote on GitHub for the docslikecode.com website: What if you could use GitHub, static site generators, and Continuous Integration and Deployment (CI/CD) for our documentation? I imagine you can track your backlog and get some metrics on the quality with their nice contributor graphs. I bet you could measure “docs drift” to […]