Quantifying the Impact of Documentation: Findings from DORA Research
summary
DORA research measures internal documentation as one composite quality score (from eight attributes) and ties it to concrete outcomes: teams with high-quality docs are 3.8× more likely to implement security practices, 2.5× more likely to leverage the cloud, 2.4× more likely to meet reliability targets and 3.5× more likely to adopt SRE. Continuous integration plus good docs amplifies org performance (translates from ~34% to ~750% impact on revenue/customer satisfaction). Improvements come from training, clear ownership, distributing doc work, CI/CD inclusion, deleting stale content and recognizing doc work.
AI-written summary · about
chapters (21)
- 0:00Introduction
- 0:44Measuring documentation impact
- 2:08DORA research overview
- 4:12Internal docs quality measurement
- 5:39Docs in technical practices
- 7:02Quantified docs impacts
- 9:52Documentation’s role in organizational performance
- 13:04Improving docs quality
- 18:00Applying findings beyond internal documentation
- 19:46Key takeaways
- 20:29Q&A
- 21:11Causation vs correlation
- 24:40Prioritizing docs with limited resources
- 26:22External docs quality attributes
- 30:16Economic conditions and documentation quality
- 32:02Distributing docs work
- 33:49Practices that undermine documentation quality
- 34:31Docs quality attributes origin
- 35:13Docs value across teams
- 36:37Research-backed docs guidelines
- 37:38End-user docs benefits
related talks
43mAmplifying Impact: Documentation and Supply Chain Security
27mThe hidden power of information assets The role of documentation in product success
34mProving and improving the value of your docs
20mOh My Docs!
20mDo Docs Better: Practical Tips on Delivering...
44mCreating a Culture of Documentation
24mDocs Advocacy is Dev Advocacy
38mThe Power of Two: How Support and Docs Teams Transform Technical Content Quality