Docs As Code (also known as “Docs Like Code”) is a popular approach to delivering documentation for software projects.

There are three common themes that you can expect to see.

1. Adopt an “agile” approach to content creation
2. The whole team is responsible for content, not just the technical writers
3. A culture of adaptation and improvement to both content, and processes, over time.

Docs As Code image copyright Anne Gentle. Released under an MIT license.

• Deliver valuable documentation faster with higher quality, because there are multiple voices working collaboratively
• Avoid documentation being a bottleneck in the release cycle
• Release technical writers to deliver higher value content (information architecture, customer experience, ....)
• Remove need for proprietary technical writing and publication tools.

Use developer tools, and process, to create and deliver content. Specifically:

1. Text based file content with embedded, lightweight, markup tags. Examples include Markdown, reStructuredText, AsciiDoc

2. Developer based workflows. For example:

   1. Version Control using tools, such as Git
   2. Change control driven though bugs and feature requests tickets
   3. Content reviews and merges

3. Machine generated content

4. Automated testing and verification

5. Continuous delivery, using static site generators (for example Sphinx or Hugo). Note: This process is optional