Docs Like Code: Strategies and Stories

When you treat docs like code, you multiply everyone’s efforts and streamline processes through collaboration, automation, and innovation. The benefits are real, but these efforts are complex. The ways you can leverage developer process and tools vary widely. Let’s unpack the absolute best situation for using a docs as code model. Then, we can walk through multiple considerations that may point you in one direction or another. We can talk about version control, publishing, REST API considerations, source formats, automation, quality controls and testing, and lessons learned. Let’s study best practices that are outcome-dependent and situational, creating strategic efforts.


Anne Gentle

Anne Gentle is a senior developer experience engineer with Cisco DevNet. She advocates for developers using technology to make infrastructure automation consistent and reliable. Anne uses ...