Where is the Documentation?

agile documentationHere is an interesting blog post from Dave Nicolette, about the absence of documentation in agile software development.

I’m not quite sure where the eggplant parmesan comes into it! I think Dave might have been drinking :-) Nevertheless it’s an interesting and thought-provoking article.

In my opinion, some lightweight documentation helps to bring structure to people’s thinking, and obviously helps to share important information between people in the team. But it becomes counter-productive when it goes over the top, which sadly is all too common in software development!

That’s why I love User Stories for capturing requirements. They add structure to the process. But keep things lightweight and simple.

Kelly.

One Response to “Where is the Documentation?”

  1. David Carver says:

    I highly recommend reading Agile Documentation: A Pattern Guide Lightweight Documents.

    http://www.amazon.com/Agile-Documentation-Producing-Lightweight-Documents/dp/0470856173

    Documentation can be agile, but as you said, more often than not it is not.

Leave a Reply

What is 3 + 9 ?
Please leave these two fields as-is:
Please do this simple sum so I know you are human:)

There are 101 ways to approach anything.
To find the best way, sometimes you need expert help

What People Say

“Kelly is an Agile heavy-weight. He came in to assess my multi-million $ Agile development program which wasn’t delivering the right throughput. He interviewed most of the team and made some key recommendations that, when implemented, showed immediate results. I couldn’t ask for more than that except he’s a really nice guy as well.”

DAN PULHAM, DIGITAL DIRECTOR
TELSTRA