Your Docs Are Lying. Here's How to Catch It. | Manny Silva Interview

Interested in building a portfolio site that demonstrates your AI skills, interview prep, or other career coaching: Connect with me on LinkedIn:   / dianapayton   Learn about the docs as tests approach with technical writing author Manny Silva. See how to improve your documentation workflow. In this episode of Technical Writing Uncensored, I sit down with Manny Silva to discuss his latest work in the field. We focus on his book, Docs as Tests, and how this methodology changes the way we approach technical documentation. If you are looking to bridge the gap between your testing environment and your user manuals, this conversation offers direct insights into how to integrate these practices effectively. We also cover the latest updates to Doc Detective, a tool designed to streamline technical writing tasks. Manny explains the new functionality he has added and why these features are useful for technical writers managing complex documentation projects. Whether you are writing books or managing software docs, these updates provide practical ways to automate and verify your content. Subscribe for weekly technical writing breakdowns, and comment below if you want to see a full tutorial on Doc Detective features. 📚 Resources mentioned: Doc Detective: https://doc-detective.com Doc Detective Agent Tools: https://github.com/doc-detective/agen... Manny's blog, Instruction Manuel: https://instructionmanuel.com/ If you got value from this conversation, please like, subscribe, and hit that bell icon. It really helps the channel. 0:00 Welcome & Intro 1:37 New Book: Docs as Tests and AI 5:34 Doc Detective's Agent Toolkit 9:17 DEMO: Doc Detective Repo Walkthrough 10:32 DEMO: Inline Test Statements Explained 15:15 DEMO: Installing the GitHub Action Skill 18:20 DEMO: Configuring the Workflow (Interactive Setup) 19:48 DEMO: The Self-Healing Loop in Action 23:42 DEMO: Exploring the Agent Skills Repo 30:23 DEMO: The Generate Tests Skill 33:06 DEMO: Custom Agents vs. Skills 34:17 DEMO: Hooks — The Quality Control Layer 36:26 What's Next + How to Get Started 37:04 Outro #TechnicalWriting #TechComm #DocsAsCode #Documentation #TechnicalWritingUncensored #DocsOrItDidntHappen #DeveloperExperience #WriteTheDocs #KnowledgeManagement #ContentStrategy #TechnicalWriter #TechWriterLife #TechnicalWritingUncensored #TechnicalWriter #TechnicalWriting #Documentarian #Documentation #WordNerds #TechComm #ContentStrategy #WritingTips #CareerAdvice #UserExperience #DocsLikeCode #TechWritingUncensored #TechCommunity