Chapter 10

Avoiding Traditional Documentation

We embrace documentation, but not hundreds of pages of never-maintained and rarely-used tomes. #agilemanifesto

—@sgranese on Twitter

I don’t know many developers who love traditional forms of documentation. I’ve been collecting alternatives for years, some of which look like documentation and some of which don’t. As a continuation of Chapter 1, “Rethinking Documentation,” this chapter rebels against the documentation establishment (see Figure 10.1) and explores a number of techniques that contribute to the preservation and sharing of knowledge but that are usually not thought of as documentation techniques.

Figure 10.1 NODocumentation is a manifesto for exploring alternatives to traditional ...

Get Living Documentation: Continuous Knowledge Sharing by Design, First Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.