Is the job of project documentation constantly being overlooked, while your Agile developers look for other low hanging fruit that's more fun to develop and produces more impressive results when it's time to unveil the weekly progress? The Agile development process may have reduced the need for documentation, but that doesn't mean generating documentation shouldn't be an important part of every sprint.
"Agile development has been very effective at reducing the need for extensive, ponderous documentation. However, this methodology has not done away with the need for documentation entirely. It has simply moved documentation from a foundational role to a supportive role." -Jason Tee
In this article for TheServerSide, Jason Tee has provided a few tips on how to get your developers producing the quality documentation that should be part of every Agile development process. The basic tips? Here's the Reader's Digest version for those who don't want to read the full article.
- Focus on Reality
- Document Decisions
- Who Needs to Know?
- Use Your Writers Appropriately
- Favor Accuracy and Brevity
- Use Self-Documenting Code
- Do the Minimum Required