GrowingAgilePractices2004 Identifying Ways to Promote a more Agile Workplace.
Topic: Documentation, Need for and Amount of
Initiator: Bohdan Hanchuk
Participants: Martin, Scott, Costa, Dimitri, Joe Rainsberger
Discussion Summary:
- Varying perspectives. Varying needs. Varying forces. Highly context sensitive.
- "Document with purpose". Continually question (understand) purpose of, need for, documentation. Don't document if no value.
- Temporary (e.g. sketches ) vs. persistent (e.g. glossary/dictionary, standards, …)
- Document types(e.g. requirements, use cases, models, …), level of detail, form and medium vary greatly and depends on environment, nature of team, nature of project.
- General comments/opinions: Often too much, often not current (obsolete), often not necessary, often requested by those who don't understand processes/need.
- References: www.agilemodeling.com
'
Conclusions / Proposals / Actions:
There is no singe answer, no single approach, no right answer.
Post-Meeting Discussion:
Suggestion: if you decide to take this discussion offline to a newsgroup, please indicate the location of the group here so others can join you.