Living Documentation: Continuous Knowledge Sharing by Design, First Edition

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