DocOps Principles


DocOps principles establish the set of values by which DocOps efforts abide. All DocOps processes, tools, and goals are ultimately grounded on the following principles:

  • Principle of generative content: Every object in the enterprise possesses latent self-describing properties; thus, the majority of enterprise documentation can and should be generated using automated methods.
  • Principle of shared responsibility: Everyone in the extended enterprise—including contractors, partners and customers—are responsible for the creation and maintenance of documentation.
  • Principle of truth proximity: Documentation’s content should be as close as possible to its source in terms of time, content, and medium.
  • Principle of low cognitive load: DocOps efforts—the implementation of new technology, and processes—must observe the fact that there is a natural limit to how much information humans can process at one time.

© 2022-2024 Ernesto Garbarino | Contact me at ernesto@garba.org