Docs as Code Is A Broken Promise

Logo
Presented by

Sarah Moir > Hosts: Patrick Bosek and Scott Abel

About this talk

Join us for a chat with Sarah Moir, Senior Technical Writer at Sigma Computing, as we delve into the realities of the Docs as Code philosophy—a method that promises to integrate documentation seamlessly into software development workflows using the same tools and processes. While appealing in theory, the practical application often falls short. On this episode of Coffee and Content, we'll explore the inherent challenges, including the complexity of Git, inconsistent documentation tools, and the need for significant custom tooling, that impact technical documentation teams that adopt the Docs as Code approach. You'll discover why Docs as Code may not be a one-size-fits-all solution for technical documentation and learn about the adjustments needed to truly fulfill its promise. Whether you're a technical writer, software developer, or documentation manager, this discussion will provide insights into the complexities of implementing Docs as Code effectively. Each 60-minute episode is recorded live. On-demand recordings are made available shortly after the live show ends. Can’t make it? Register, and we’ll send you a link to watch the recording when it’s convenient for you. Coffee and Content is brought to you by The Content Wrangler and sponsored by Heretto, a powerful component content management system (CCMS) platform for deploying help and API documentation in a single portal designed to delight customers.
Related topics:

More from this channel

Upcoming talks (54)
On-demand talks (676)
Subscribers (73830)
The Content Wrangler Channel covers the people, methods, tools and technologies designed to help you deliver the right information, to the right people, at the right time, on the right device, in the right format and language. Your content is your most valuable business asset. Let us show you how to manage it efficiently and effectively.