Docs as Code: Publishing Processes for API Experiences

When you treat docs like code, you multiply everyone’s efforts and streamline processes through collaboration, automation, and plain old hard work. To create a cohesive API experience, developers, technical marketing engineers, technical writers, and product managers can collaborate on GitHub to produce web pages and API documentation, including interactive API docs and tutorials.

The ways you can leverage developer processes and tools in a docs-as-code system vary widely. Let's walk through some examples: tools, version control, publishing workflows, approvals, source formats, checklists, automated testing, and final approval.

Also, let's take some time to share some of the pitfalls and difficulties possible when you work on API and tools documentation for an extensive and varied product catalog with more than a thousand contributors.