As technical communicators, this challenge most likely resonates with you -- how do you keep docs in sync with your product? In the words of Manny Silva, "When product updates are frequent and user expectations are high, maintaining accurate and up-to-date documentation isn’t just a necessity—it’s a competitive advantage."

Manny proposes. Docs as Tests, a strategy that keeps your docs in sync with your product. It’s a way to test your docs, just like engineers test their code.

As Manny joins me,  we unravel the story of Doc Detective—an innovative tool that challenges the status quo by ensuring documentation remains in lockstep with product functionality. Through a case study and demo,  Manny shares how Doc Detective tests your content against your product UIs and APIs to ensure that your docs are always accurate, complete, and relevant.

Where can you view the demo?

View the demo (24:04 to 34:24) at this link. 

Resources

• Docs as Tests blog
• Doc Detective Github (open to contributions!)
• Doc Detective documentation (open to contributions!)
• Doc Detective Discord channel (for questions and contributors)

Events to attend where Manny will be presenting in 2024

• Write the Docs, Portland 
• Linux Foundation Open Source Summit on April 18th
• STC Summit on May 17th

Guest Bio

A tech writer by day and engineer by night, Manny Silva is Head of Docs at Skyflow, codifier of Docs as Tests, and the creator of Doc Detective. He’s passionate about intuitive and scalable developer experiences and likes diving into the deep end as the 0th developer.

Show Credits

• Intro and outro music - Az
• Audio engineer - RJ Basilio