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.
Meet the Presenter
Anne Gentle is an industry-recognized author whose books promote collaboration among developers, writers, and other stakeholders within open source and enterprise communities. She works as a product manager at Cisco, supporting the Metacloud product based on OpenStack. She supports open source tools for API design, documentation, and developer support. She wrote the book, Docs Like Code, to share tested tools and techniques with all who want to provide helpful, accurate technical information to the world.