))
S5E2 Innovative Tool To Keep Docs in Sync with Your Product with Manny Silva
Manage episode 413144925 series 2891683
Contenu fourni par Zohra Mutabanna. Tout le contenu du podcast, y compris les épisodes, les graphiques et les descriptions de podcast, est téléchargé et fourni directement par Zohra Mutabanna ou son partenaire de plateforme de podcast. Si vous pensez que quelqu'un utilise votre œuvre protégée sans votre autorisation, vous pouvez suivre le processus décrit ici https://fr.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
Chapitres
1. S5E2 Innovative Tool To Keep Docs in Sync with Your Product with Manny Silva (00:00:00)
2. Elevating Tech Writing With Documentation Tests (00:00:04)
3. Benefits of Open Source Doc Detective (00:15:58)
4. Doc Detective Testing and Demo (00:20:10)
5. Benefits of DocDetective for Documentation (00:33:26)
6. Knowledge Sharing Podcast Interview (00:45:29)
49 episodes
Partager
