Docs as Tests: A Strategy for Resilient Technical Documentation
Sprache: Englisch
Verlag: Boffin Education, 2025
- Softcover
- Gebraucht

Anbieter: ThriftBooks-Atlanta, AUSTELL, GA, USAThriftBooks-Atlanta
Verkäufer:in bei AbeBooks seit 24. März 2009
Zustand: Gebraucht - Gut
EUR 16,12
Anzahl: 1 verfügbar
In den WarenkorbArtikelbeschreibung des Verkäufers
May have limited writing in cover pages. Pages are unmarked. ~ ThriftBooks: Read More, Spend Less.
Bestandsnummer des Verkäufers G0994169361I4N00
- Titel
- Docs as Tests: A Strategy for Resilient Technical Documentation
- Autor
- Silva, Manny
- Verlag
- Boffin Education
- Erscheinungsjahr
- 2025
- Zustand
- Very Good
- Schutzumschlag
- No Jacket
- Einband
- Paperback
- Sprache
- Englisch
- ISBN-10
- 0994169361
- ISBN-13
- 9780994169365
- Artikelgewicht
- 0,55 Pfund
Keeping documentation accurate is a constant battle—especially when products change rapidly. Docs as Tests 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.
Manny 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.
What You’ll Learn:
- Why documentation errors happen—and how to prevent them before users notice.
- How to automate the testing of UI docs, API references, and code examples.
- Practical strategies for integrating documentation testing into your development workflow.
- Best practices for keeping documentation and products in sync, even in fast-moving environments.
Who This Book Is For:
- Technical writers looking to keep documentation accurate despite frequent product updates.
- Developers and engineers who contribute to docs and want reliable ways to verify them.
- Product managers who understand the role of docs in adoption and user success.
- QA professionals interested in extending testing frameworks to documentation.
Praise for This Book
“Docs as Tests 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.”
Carlos Evia, Professor and Chief Technology Officer; CLAHS, Virginia Tech
“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.”
Jake Cahill, Senior Principal Technical Writer at Redpanda Data
“Docs as Tests 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.”
Sarah Sanders, Technical Writer at Docker
“Docs as Tests 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.”
Lorna Mitchell, OpenAPI Initiative
“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.”
Anne Gentle, Consultant, Just Write Click
“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.”
—Adam Altman, Founder of Redocly
„Inhaltsangabe“ gehört möglicherweise zu einer anderen Auflage dieses Titels.
ThriftBooks-Atlanta
AUSTELL, GA, USA
Verkäufer:in bei AbeBooks seit 24. März 2009
Versandkosten innerhalb von USA
| Artikel | 4 bis 8 Werktage | 4 bis 8 Werktage |
|---|---|---|
| Erster Artikel | EUR 0,00 | EUR 0,00 |
Zahlungsarten
Shopbeschreibung
ThriftBooks is a fully independent seller of used books, having sold more than 160 million used and new books since we started in 2003. Each quality used book is sorted, graded, shelved and shipped by hand by our team of dedicated employees in our seven warehouses across the US. We have the best selection of books, in the right condition and format, at everyday low prices. We also have a dedicated, US-based Customer Service team, ranked in the top three by Newsweek for Best Customer Service in 2018 and 2019, so you can shop with confidence. We support and invest in our employees, appreciate and value our customers, and truly believe in the power of the written word to educate, energize, and engage readers of all ages and interests.…
Unternehmensdaten der Verkäuferin bzw. des Verkäufers
Thrift Books Global, LLC
18300 Cascade Ave S, Ste 150
Seattle, WA USA 98188
Verkaufsbedingungen
We guarantee the condition of every book as it's described
on the Abebooks website. If you're dissatisfied with your
purchase (Incorrect Book/Not as Described/Damaged) or if the
order hasn't arrived, you're eligible for a refund within 30
days of the estimated delivery date. If you've changed your
mind about a book that you've ordered, please use the "Ask
bookseller a question link to contact us" and we'll respond
as soon as possible.
Widerrufsrecht
Wenn Sie Verbraucher sind, können Sie gemäß den folgenden Bestimmungen vom Vertrag zurücktreten. Verbraucher ist jede natürliche Person, die zu Zwecken handelt, die nicht ihrer kaufmännischen, gewerblichen, künstlerischen oder beruflichen Tätigkeit zugerechnet werden können.
Informationen zum Widerrufsrecht
Gesetzliches Widerrufsrecht
Sie haben das Recht, den Vertrag innerhalb von 14 Tagen ohne Angabe von Gründen zu widerrufen.
Die Widerrufsfrist beträgt 14 Tage ab dem Tag, an dem Sie oder ein von Ihnen benannter Dritter, der nicht der Transporteur ist, die letzte Ware oder den letzten Posten oder das letzte Exemplar in Besitz genommen hat.
Um das Widerrufsrecht auszuüben, füllen Sie auf unserer Website unter „Meine Einkäufe" in „Mein Nutzerkonto" eine eindeutige Erklärung elektronisch aus und senden Sie sie ab. Wir werden Ihnen unverzüglich eine Bestätigung über den Eingang eines solchen Widerrufs auf einem dauerhaften Datenträger (z. B. per E-Mail) übermitteln.
Um die Widerrufsfrist einzuhalten, reicht es aus, dass Sie Ihre Mitteilung über die Ausübung des Widerrufsrechts vor Ablauf der Widerrufsfrist absenden.
Auswirkungen des Widerrufs
Wenn Sie diesen Vertrag widerrufen, erstatten wir Ihnen alle Zahlungen, die wir von Ihnen erhalten haben, einschließlich der Lieferkosten (mit Ausnahme der zusätzlichen Kosten, die entstehen, wenn Sie eine andere Art der Lieferung als die von uns angebotene günstigste Standardlieferung gewählt haben).
Wir können einen Abzug von der Rückerstattung für den Wertverlust der gelieferten Waren vornehmen, wenn der Verlust auf eine unnötige Behandlung durch Sie zurückzuführen ist.
Wir werden die Rückerstattung unverzüglich und nicht später als 14 Tage nach dem Tag vornehmen, an dem wir über Ihre Entscheidung, diesen Vertrag zu widerrufen, informiert wurden.
Für die Rückerstattung verwenden wir dasselbe Zahlungsmittel, das Sie für die ursprüngliche Transaktion verwendet haben, es sei denn, Sie haben ausdrücklich etwas anderes vereinbart; in keinem Fall werden Ihnen aufgrund einer solchen Rückerstattung Gebühren berechnet.
Wir können die Rückzahlung verweigern, bis wir die Waren wieder zurückerhalten haben oder Sie den Nachweis erbracht haben, dass Sie die Waren zurückgesandt haben, je nachdem, was eher eintritt.
Sie müssen die Waren unverzüglich und in jedem Fall spätestens 14 Tage ab dem Tag, an dem Sie uns über den Widerruf dieses Vertrags unterrichten, an ThriftBooks-Atlanta, Dallas, Texas, U.S.A., zurücksenden oder übergeben. Die Frist ist eingehalten, wenn Sie die Ware vor Ablauf der Frist von 14 Tagen zurücksenden. Sie müssen die direkten Kosten der Rücksendung der Waren tragen. Sie haften nur für einen etwaigen Wertverlust der Waren, der auf eine Behandlung zurückzuführen ist, die nicht zur Prüfung der Art, Eigenschaften und Funktionsweise der Waren erforderlich ist.
Ausnahmen vom Widerrufsrecht
Das Widerrufsrecht gilt nicht für:
- Die Lieferung von Zeitungen, Zeitschriften oder Magazinen mit Ausnahme von Abonnementverträgen; und
- Die Lieferung digitaler Inhalte, die nicht auf einem physischen Medium (z. B. auf einer CD oder DVD) geliefert werden, wenn Sie bei Ihrer Bestellung akzeptiert haben, dass wir mit der Lieferung beginnen können und dass Sie nach Beginn der Lieferung den Vertrag nicht mehr widerrufen können.
Versandbedingungen
All domestic Standard and Expedited shipments are distributed from our warehouses by OSM, then handed off to the USPS for final delivery.
2-Day Shipping is delivered by FedEx, which does not deliver to PO boxes.
International shipments are tendered to the local postal service in the destination country for final delivery – we do not use courier services for international deliveries.