DocOps describes the method of using human readable and editable plain text documentation as source for applying changes in another system. By keeping both parts in sync, the documentation becomes the single source of truth for both humans and computers
In the spirit of the DevOps movement the DocOps method combines human written documentation with it’s execution on the system it documents. Making human written documents executable just like an applications.
The majority of documentation artifacts and system state consist of content that rarely changes. Only small but important parts are changed regularly. This is the sweet spot where the DocOps concept provide a benefit by making sure that the regularly changed content is always up-to-date. DocOps is in general the concept of having an executable documentation, or enrichment of documentation based on execution results.
When applying the DocOps Method this principles will serve as guardrails.
DocOps as described on the internet prior 2018, 2019 as Documentation with Dev Tools and Mindset.
What is the differentiation to other potential similar concepts.
[TODO]
As with all xyzOps concepts tools are the mortar that make bricks stick together. As of now there aren’t any tools that are specifically designed
[TODO]
Example of good and bad DocOps practice:
Scenario: Generate Reverse Proxy Config for HAProxy/Nginx from documentation. Provide markdown example.
Good Practice: Do ... [TODO]
Bad Practice: Enriched documents should be up to date or the enriched content should be valid for a long period of time at least double the mean time between average document generation.
Code too Docs An existing common practice is to enrich the existing documentation with code execution results. In this case the user is editing the config files and scripts and as an output of this the documentation is updated with predefined injection points.
Be part of the DocOps movement, as the concept and practice are still evolving there are many opportunities and possibilities to contribute and influence the direction. You don’t have to be a developer or alike to contribute. Everyone with a brain is welcome.
This is a short list of topic that are alway welcome and simple to accomplish.
More to come in the future on https://DocOps.info