Technical writing with Continuous Integration and docs-as-code
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 […]
How to use Jekyll to create a versioned documentation site – configuration options for maintaining software and code versions with docs source versions.
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 […]