))
S5E2 Innovative Tool To Keep Docs in Sync with Your Product with Manny Silva
Manage episode 413144925 series 2891683
Content provided by Zohra Mutabanna. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by Zohra Mutabanna or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://player.fm/legal.
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
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
41 episodes
Share
