{"product_id":"docs-as-tests-a-strategy-for-resilient-technical-documentation-9780994169365","title":"Docs as Tests: A Strategy for Resilient Technical Documentation","description":"\u003cp\u003e • Author(s): Manny Silva\u003cbr\u003e • Publisher: Boffin Education\u003cbr\u003e • Publisher Imprint: Boffin Education\u003cbr\u003e • BISAC: Technical Writing\u003c\/p\u003e\u003cp\u003e\u003cb\u003eHave you ever discovered that your documentation was wrong-only after a user reported it?\u003c\/b\u003e \u003c\/p\u003e\u003cp\u003e\u003c\/p\u003eKeeping documentation accurate is a constant battle-especially when products change rapidly. \u003ci\u003eDocs as Tests\u003c\/i\u003e introduces a game-changing approach: treating documentation as part of the testing process. By automating documentation validation, you can make sure that every guide, API reference, and code snippet stays correct as your product evolves. \u003cp\u003e\u003c\/p\u003eManny Silva has spent over fifteen years working with companies like Apple, Google, and Skyflow to improve technical documentation. Frustrated by the struggle to keep docs in sync with fast-moving products, he pioneered the Docs as Tests strategy and built Doc Detective, an open-source tool for automated documentation validation. Now, he shares his expertise to help teams future-proof their documentation. \u003cp\u003e\u003c\/p\u003e\u003cb\u003eWhat You'll Learn: \u003c\/b\u003e\u003cul\u003e\n\u003cli\u003eWhy documentation errors happen-and how to prevent them before users notice.\u003c\/li\u003e\n\u003cli\u003eHow to automate the testing of UI docs, API references, and code examples.\u003c\/li\u003e\n\u003cli\u003ePractical strategies for integrating documentation testing into your development workflow.\u003c\/li\u003e\n\u003cli\u003eBest practices for keeping documentation and products in sync, even in fast-moving environments.\u003c\/li\u003e\n\u003c\/ul\u003e\u003cbr\u003e\u003cb\u003eWho This Book Is For: \u003c\/b\u003e\u003cul\u003e\n\u003cli\u003e\n\u003cb\u003eTechnical writers\u003c\/b\u003e looking to keep documentation accurate despite frequent product updates.\u003c\/li\u003e\n\u003cli\u003e\n\u003cb\u003eDevelopers and engineers\u003c\/b\u003e who contribute to docs and want reliable ways to verify them.\u003c\/li\u003e\n\u003cli\u003e\n\u003cb\u003eProduct managers\u003c\/b\u003e who understand the role of docs in adoption and user success.\u003c\/li\u003e\n\u003cli\u003e\n\u003cb\u003eQA professionals\u003c\/b\u003e interested in extending testing frameworks to documentation.\u003c\/li\u003e\n\u003c\/ul\u003eIf you care about keeping your documentation accurate and reliable, this book will show you how. \u003cp\u003e\u003c\/p\u003e\u003cb\u003ePraise for This Book\u003c\/b\u003e \u003cp\u003e\u003c\/p\u003e\u003cb\u003e\"\u003ci\u003eDocs as Tests\u003c\/i\u003e brings documentation to life. Discover how tests can adapt to your specific documentation needs (start with a cupcake) before diving into advanced workflows (a whole wedding cake). This resource is easy to read and informative for both practitioners and students of modern technical writing.\"\u003c\/b\u003e\u003cbr\u003eCarlos Evia, Professor and Chief Technology Officer; CLAHS, Virginia Tech \u003cp\u003e\u003c\/p\u003e\u003cb\u003e\"If your docs aren't tested, they're one code change away from being wrong. This book is all about turning documentation from a static resource into a living, tested asset. If you've ever struggled with outdated docs, you need this.\"\u003c\/b\u003e\u003cbr\u003eJake Cahill, Senior Principal Technical Writer at Redpanda Data \u003cp\u003e\u003c\/p\u003e\u003cb\u003e\"\u003ci\u003eDocs as Tests\u003c\/i\u003e transformed the way I approach writing, maintaining, and evangelizing documentation. With this approach, you can give your users confidence that your documentation reflects the current state of your products and APIs. This confidence builds the trust that's essential for adoption and success.\"\u003c\/b\u003e\u003cbr\u003eSarah Sanders, Technical Writer at Docker \u003cp\u003e\u003c\/p\u003e\u003cb\u003e\"\u003ci\u003eDocs as Tests\u003c\/i\u003e weaves a rich tapestry of ideas around documentation as a source of truth, and testing as a source of confidence. Investing in more accurate docs builds user trust, and therefore makes your product more valuable. Every team will find something in this book that they can adopt to improve their docs.\"\u003c\/b\u003e\u003cbr\u003eLorna Mitchell, OpenAPI Initiative \u003cp\u003e\u003c\/p\u003e\u003cb\u003e\"The techniques in this book help technical writers and developers create reliable, up-to-date documentation that evolves alongside production code. I learned a lot while reading this book, and I plan to prioritize test creation in my documentation projects.\"\u003c\/b\u003e\u003cbr\u003eAnne Gentle, Consultant, Just Write Click \u003cp\u003e\u003c\/p\u003e\u003cb\u003e\"Great products deserve great docs-but too often they're built in isolation. Manny Silva lays out a clear, actionable path to bring them together. If you're ready to close the gap, start with this book.\"\u003c\/b\u003e\u003cbr\u003e\u003cb\u003e-\u003c\/b\u003eAdam Altman, Founder of Redocly\u003cbr\u003e","brand":"Boffin Education","offers":[{"title":"Paperback","offer_id":45505434878103,"sku":"9780994169365","price":2029.0,"currency_code":"INR","in_stock":false}],"thumbnail_url":"\/\/cdn.shopify.com\/s\/files\/1\/0666\/3471\/1191\/files\/9780994169365.webp?v=1768588481","url":"https:\/\/atlanticbooks.com\/products\/docs-as-tests-a-strategy-for-resilient-technical-documentation-9780994169365","provider":"Atlantic Books","version":"1.0","type":"link"}