 |
|
Title: Agile Documentation: A Pattern Guide to Producing Lightweight Documents for Software Projects (Wiley Software Patterns Series)
ISBN: 0470856173
Author:
Andreas Rueping
Publicate Date: 2003-09-19
Publish: 2003-09-19
List Price: $50.00
Average Customer Rating: 4.0
Format: Paperback
 |
|
|
|
|
Amazon Lowest New Price: $22.23
Amazon Lowest Used Price: $18.99
Amazon Merchant Price: $35.00
|
|
|
|
|
|
|
|
|
|
|
| Customer Review: |
|
1: Left me wondering what to actually do ...
I was a bit disappointed with the book since our team has struggled with documentation. The general consensus was that this book was OK but did not really clear a whole lot things up for us.
|
2: Useful book!
This book about Agile Documentation turned out to be very useful, and is a kind of book I have been looking for. A lot of the same issues and conclusions regarding Software documentation we have discussed in our own Company are discussed in this book, and the advices from the author is very good. Written in a style that makes it easy and fast to read.
Everyone working with documentation in the software business should read this book!
|
3: Great concept
As a tech communicator with long experience in various engineering environments, I am enthused about the concepts espoused here. We need to write "documentation" the way we like to read "documentation"; it needs to have the content needed particularly by us, in the style we need, and concise and to the point when our need begs for that. We need to look toward long term relevance and up-to-dateness - of all technical information, especially technical reference information, and it is more likely to be so if it is concise and focused to start with. We are all scanners, doing stuff or acquiring information in a hurry, doing tasks in a hurry. Another book told about how a new guy on a project was given a thick document about the project. Two days later, he had a headache; couldn't get the picture. If he were given an agile-ly written doc, he would have gotten the picture. Ginny Redish (Letting Go of the Words) is another great one along the same thinking.
ONE distractor: He wrote the book with a bit of his own fluff. Maybe to give the book a slight bit of thickness. Could have been more to the point. An engineer I used to work with used to say "paid by the pound".
|
4: Documentation, But not very agile
Ruping did a good job of covering the topic of software documentation, albeit somewhat generically, i.e. not that specific to software development. He quotes a lot of others in his book and identifies that the goal (of agile documenting) is 'light-weight but sufficient'. If you're working on developing a system for documenting software development (or really any other technical project) this would make a good reference, but start at the back of the book. He uses patterns in his book as his technique to cover the topic. They are recognized problems and solutions, and he lists all of them in the back of the book in thumbnail form. The middle of the book provides the elaboration. The first part of the book is his professional history (sorry Ruping, but not that interesting), and his how-to-use-the-book section.
The problem I had with the book is that I didn't see anything new and innovating. I didn't have an `ah-ha' moment where I finally understood the real principles behind 'agile' documentation. I didn't find this book 'agile' at all. I also did not agree with all of his solutions, most seemed clich??. But again, if you're looking for a reference on the topic of technical documentation - this is not bad.
|
|
|
|
|
