Home → Agile-Book → documentation

(book cover)

Order it now!

Welcome to the The Art of Agile Development website. Think of this as the "special features" DVD for the book, only without the DVD. (If you haven't bought the book yet, that's okay... we won't tell if you don't.) Here, you'll find a cornucopia of bonus material, such as downloadable posters, behind-the-scenes material, and new insights.

For more bonus material, see the table of contents.

(If you're getting a 404, this chapter has yet to be posted. Try the table of contents instead.)

 Print

The Art of Agile Development: Documentation

by James Shore

03 Sep, 2008

in 99 words

Projects use three main types of documents: work-in-progress; product; hand-off.

Work-in-progress documents communicate, and other forms of communication may replace them. High-bandwidth communication replaces some work-in-progress documents. Test-driven development creates executable low-level design specifications. Customer tests describe high-level behavior, and a ubiquitous language further clarifies intent.

Product documents have business value--schedule them with stories.

Handoff documents are best and most accurate at the end of the project. Set aside time after delivery to create them, and consider conducting an incremental handoff using pair programming and collective ownership.

Commentary

The Documentation Myth

Inside the Book

  • Documentation
  • Work-In-Progress Documentation
  • Product Documentation
  • Handoff Documentation
  • Questions
    • Isn't it a risk to reduce the amount of documentation?
  • Results
  • Contraindications
  • Alternatives

Loading...

Home → Agile-Book | Comments (...)

Loading comments...