Content Strategy Interviews

Manny Silva: Docs as Tests for Resilient Technical Documentation – Episode 213

Informações:

Sinopse

Manny Silva Technical documentation of software products is critical work that needs to accurately inform end users, regardless of how quickly and substantially the software might be changing. Manny Silva has created the Docs as Tests, a system that integrates a set of well-developed practices and a collection of engineering tooling, to help technical communicators streamline and constantly improve their software documentation work. We talked about: his work at Skyflow and his new book "Docs as Tests" and a new version of his Doc Detective software the variety of "docs as" strategies that have emerged in technical documentation the intent of Docs as Tests to validate the accuracy of documentation the principles that underlie his approach to documentation the truism that in software "something always breaks" and the way Docs as Tests addresses this issue the tools available to test documentation the origins of his Doc Detective tool, which integrates developer tools in a tech-writer-friendly