Have you ever discovered that your documentation was wrong—only after a user reported it?

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.

If you care about keeping your documentation accurate and reliable, this book will show you how.

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

“Sinopsis” puede pertenecer a otra edición de este título.

ThriftBooks-Atlanta

AUSTELL, GA, Estados Unidos de America

Vendedor de 5 estrellas

Vendedor de IberLibro desde 24 de marzo de 2009

Tarifas de envío en Estados Unidos de America

Artículo	De 4 a 8 días hábiles	De 4 a 8 días hábiles
Primer artículo	EUR 0,00	EUR 0,00

Los plazos de entrega los establecen los vendedores y varían según el transportista y la ubicación. Los pedidos que pasan por la aduana pueden sufrir retrasos y los compradores son responsables de los aranceles o tarifas asociadas. Los vendedores pueden ponerse en contacto con usted en relación con cargos adicionales para cubrir cualquier aumento en los costes de envío de los artículos.

Métodos de pago

Descripción de la tienda

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.…

Información empresarial del vendedor

Thrift Books Global, LLC

18300 Cascade Ave S, Ste 150
Seattle, WA Estados Unidos de America 98188

Contactar con el vendedorVer los artículos de este vendedorVer la página principal del vendedor

Condiciones de venta

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.

Derecho al desistimiento

Si es un consumidor, puede rescindir el contrato de acuerdo con lo siguiente. Por consumidor se entiende cualquier persona física que actúe con fines ajenos a su actividad comercial, empresarial, oficio o profesión.

Información sobre el derecho de desistimiento

Derecho legal de desistimiento

Tiene derecho a rescindir este contrato en un plazo de 14 días sin dar ningún motivo.

El periodo de desistimiento vencerá a los 14 días desde que usted, o un tercero que no sea el transportista e indicado por usted, adquiera la posesión física del último bien o del último lote o pieza.

Para ejercer el derecho de desistimiento, complete de forma electrónica y envíe una declaración clara en nuestro sitio web, desde "Mis compras" en "Mi cuenta". Le enviaremos sin demora un acuse de recibo de dicho desistimiento a través de un soporte duradero (por ejemplo, por correo electrónico).

Para cumplir con el plazo de desistimiento, basta con que envíe su comunicación relativa al ejercicio del derecho de desistimiento antes de que venza el periodo de desistimiento.

Efectos del desistimiento

Si rescinde este contrato, le reembolsaremos todos los pagos que hayamos recibido de usted, incluidos los gastos de envío (excepto los gastos adicionales que surjan si elige un tipo de envío que no sea el tipo de envío estándar más económico que ofrecemos).

Podemos hacer una deducción del reembolso por la pérdida de valor de cualquier bien suministrado, si la pérdida es el resultado de una manipulación innecesaria por su parte.

Efectuaremos el reembolso sin demoras indebidas y, a más tardar, 14 días después de que se nos informe de su decisión de rescindir este contrato.

Efectuaremos el reembolso utilizando el mismo medio de pago que utilizó para la transacción inicial, a menos que haya acordado expresamente lo contrario; en cualquier caso, no incurrirá en ningún cargo como resultado de dicho reembolso.

Podremos retener el reembolso hasta que hayamos recibido los bienes o hasta que nos haya presentado una prueba de que los ha devuelto, lo que ocurra primero.

Deberá devolver los bienes o entregarlos a ThriftBooks-Atlanta, Dallas, Texas, U.S.A., sin demoras indebidas y, en cualquier caso, en un plazo máximo de 14 días a partir del día en que nos comunique su desistimiento del presente contrato. El plazo se cumple si devuelve la mercancía antes de que venza el periodo de 14 días. Tendrá que asumir los gastos directos de devolución de los bienes. Usted solo es responsable de la disminución del valor de los bienes como resultado de una manipulación distinta a la necesaria para establecer la naturaleza, las características y el funcionamiento de los bienes.

Excepciones al derecho de desistimiento

El derecho de desistimiento no se aplica a lo siguiente:

La entrega de periódicos, diarios o revistas, con la excepción de los contratos de suscripción; y
El suministro de contenido digital que no se proporcione en un soporte tangible (por ejemplo, en un CD o DVD) si, al hacer el pedido, aceptó que podíamos empezar a entregarlo y que no podría desistir una vez iniciada la entrega.

Condiciones de envío

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.

Docs as Tests: A Strategy for Resilient Technical Documentation

Descripción del artículo del vendedor

Detalles bibliográficos

Sinopsis