Chapter 22. Evocative Document

In the Evocative Document[1] practice, documents are created that evoke the memories, conversations, and situations of those who wrote the document. These documents are more meaningful and representative of a team’s understanding of the system than traditional documents.

Business Value

Evocative documents help prolong a product’s lifetime by accurately representing the team’s internal model of the software and allowing that model to be handed down from master to apprentice. The better understanding of the system over time also reduces the maintenance cost of the system over time because appropriate changes reduce the deterioration of the software.

Sketch

Aparna and Dave were on their way home from a week-long ...

Get Agile Adoption Patterns: A Roadmap to Organizational Success 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.