skip to main content
10.1145/2328909.2328926acmotherconferencesArticle/Chapter ViewAbstractPublication PageseuroplopConference Proceedingsconference-collections
research-article

How much is just enough?: some documentation patterns on Agile projects

Published:07 July 2010Publication History

ABSTRACT

Agile methods advocate "just enough" documentation on Agile projects. Unfortunately, there are no clear guidelines on what is "just enough" documentation. We describe a set of patterns to help Agile software development teams define "just enough" in their own contexts. Teams can also employ these documentation patterns as strategies to overcome common challenges of adopting Agile methods.

References

  1. Agile/Lean Documentation Strategies for Agile Software Development http://www.agilemodeling.eom/essays/agileDocumentation.htm (Feb 2010)Google ScholarGoogle Scholar
  2. Kent Beck. ---A Theory of Programming||. Dr. Dobb's Journal, Nov 2007Google ScholarGoogle Scholar
  3. Charles Connell. ---It's Not About Lines of Code|| http://www.developer.com/java/other/article.php/988641/Its-Not-About-Lines-of-Code.htmGoogle ScholarGoogle Scholar
  4. James O. Coplien, Neil B. Harrison. ---Organizational Patterns of Agile Software Development|| Pearson Prentice Hall, 2005 Google ScholarGoogle ScholarDigital LibraryDigital Library
  5. Rashina Hoda, James Noble, Stuart Marshall. ---Organizing Self-Organizing Teams||, In the Proceedings of the International Conference on Software Engineering (ICSE), Cape Town, 2010. Google ScholarGoogle ScholarDigital LibraryDigital Library
  6. Rashina Hoda, James Noble, Stuart Marshall. ---Balancing Acts: Walking the Agile Tightrope.|| Cooperative and Human Aspects of Software Engineering (CHASE) workshop at ICSE2010, South Africa, May 2010. Google ScholarGoogle ScholarDigital LibraryDigital Library
  7. Rashina Hoda, James Noble, Stuart Marshall. ---Agile Undercover: When Customers Don't Collaborate.|| XP2010, Norway, June 2010.Google ScholarGoogle Scholar
  8. Rashina Hoda, James Noble, Stuart Marshall. ---What Language Does Agile Speak?|| XP2010, Norway, June 2010.Google ScholarGoogle Scholar
  9. Ron Jeffries. Essential XP: Documentation http://xprogramming.com/xpmag/expDocumentationInXP (Feb 2010)Google ScholarGoogle Scholar
  10. Jerry Weinberg. ---Psychology of Computer Programming||Google ScholarGoogle Scholar
  11. The Agile Manifesto http://agilemanifesto.org/Google ScholarGoogle Scholar
  12. Mary Lynn Manns and Linda Rising. ---Fearless Change: Patterns for Introducing New Ideas.|| Addison-Wesley, 2005.Google ScholarGoogle Scholar
  13. Angela Martin, James Noble, Robert Biddle. ---The XP Customer Roles: A Grounded Theory||. Agile2009, Chicago, August 2009. Google ScholarGoogle ScholarDigital LibraryDigital Library
  14. Matt Stephens, Doug Rosenber. ---Extreme Programming Refactored: The Case Against XP||, Apress L. P, 2003 Google ScholarGoogle ScholarDigital LibraryDigital Library
  15. D L Parnas, P C Clements. "A rational design process: How and why to fake it||, IEEE Transactions on Software Engineering, 1986 Google ScholarGoogle ScholarDigital LibraryDigital Library
  16. Andreas Ruping. ---Agile Documentation: A Pattern Guide to Producing Lightweight Documents for Software Projects||, John Wiley, 2003 Google ScholarGoogle ScholarDigital LibraryDigital Library

Index Terms

  1. How much is just enough?: some documentation patterns on Agile projects

        Recommendations

        Comments

        Login options

        Check if you have access through your login credentials or your institution to get full access on this article.

        Sign in
        • Published in

          cover image ACM Other conferences
          EuroPLoP '10: Proceedings of the 15th European Conference on Pattern Languages of Programs
          July 2010
          329 pages
          ISBN:9781450302593
          DOI:10.1145/2328909

          Copyright © 2010 ACM

          Permission to make digital or hard copies of all or part of this work for personal or classroom use is granted without fee provided that copies are not made or distributed for profit or commercial advantage and that copies bear this notice and the full citation on the first page. Copyrights for components of this work owned by others than ACM must be honored. Abstracting with credit is permitted. To copy otherwise, or republish, to post on servers or to redistribute to lists, requires prior specific permission and/or a fee. Request permissions from [email protected]

          Publisher

          Association for Computing Machinery

          New York, NY, United States

          Publication History

          • Published: 7 July 2010

          Permissions

          Request permissions about this article.

          Request Permissions

          Check for updates

          Qualifiers

          • research-article

          Acceptance Rates

          EuroPLoP '10 Paper Acceptance Rate25of39submissions,64%Overall Acceptance Rate216of354submissions,61%

        PDF Format

        View or Download as a PDF file.

        PDF

        eReader

        View online with eReader.

        eReader