Resources

This is a collection of books and articles on Agile documentation that I've found interesting and relevant. My plan is to expand this list as I discover new resources.

These documents make no mention of LumiCode, as they are not about tools. But, as you read them, consider the value of being able to produce diagrams almost instantly. I believe this changes the whole cost/value of documentation equation for the better.

by Roger Bruvold

Books

Agile Modeling: Effective Practices for eXtreme Programming and the Unified Process

By Scott Ambler

This book is focused on modeling. Scott defines a model as “an abstraction that desribes one or more aspects of a problem or a potential solution addressing a problem". For Agile development, he promotes a minimalist, "barely adequate" approach, recommending only documentation and tools that add value to the process.

Agile Documentation: A Pattern Guide to Producing Lightweight Documents for Software Projects

By Andreas Rueping

Presented as a set of patterns, this book deals with questions about documentation. What documentation is necessary? Which topics should be covered? How should documents be structured? How can the project documentation be organized? How do you organize the documentation process? These questions are answered in this book.

Articles

Agile Documentation Strategies

By Scott Ambler

Scott supports his declaration that “Documentation is an important part of every system, agile or otherwise”.

Agile development: Don't forget the documentation

By Nancy Knettell

Nancy speaks from experience, making the case that dumping the waterfall process shouldn't mean dumping the documents.

Deep Agile Panel Questions – Documentation

From James Grenning's Blog

James answers a blog reader’s question about the need for documentation in Agile.