Agile Documentation: A Pattern Guide to Producing Lightweight Documents for Software Projects

Ruping, Andreas

ISBN 10: 0470856173 / ISBN 13: 9780470856178

Published by John Wiley & Sons 2003-08, 2003

About this Item

Seller Inventory # 6666-IUK-9780470856178

Bibliographic Details

Title: Agile Documentation: A Pattern Guide to ...

Publisher: John Wiley & Sons 2003-08

Publication Date: 2003

Binding: PF

Condition: New

About this title

Synopsis:

Software documentation forms the basis for all communication relating to a software project. To be truly effective and usable, it should be based on what needs to be known. Agile Documentation provides sound advice on how to produce lean and lightweight software documentation. It will be welcomed by all project team members who want to cut out the fat from this time consuming task. Guidance given in pattern form, easily digested and cross-referenced, provides solutions to common problems.

Straightforward advice will help you to judge:

• What details should be left in and what left out
• When communication face-to-face would be better than paper or online
• How to adapt the documentation process to the requirements of individual projects and build in change
• How to organise documents and make them easily accessible
• When to use diagrams rather than text
• How to choose the right tools and techniques
• How documentation impacts the customer

Better than offering pat answers or prescriptions, this book will help you to understand the elements and processes that can be found repeatedly in good project documentation and which can be shaped and designed to address your individual circumstance. The author uses real-world examples and utilises agile principles to provide an accessible, practical pattern-based guide which shows how to produce necessary and high quality documentation.

From the Back Cover:

Documentation is the castor oil of programming. Managers think it is good for programmers, and programmers hate it! Jerry Weinberg in Psychology of Computer Programming

Andreas Rüping sugars the pill by giving sound advice on how to produce lean and lightweight software documentation. It will be welcomed by all project team members who want to cut out the fat from this time consuming task. Guidance given in pattern form, easily digested and cross-referenced, provides solutions to common problems. Straightforward advice will help you to judge:

• What details should be left in and what left out
• When communication face-to-face would be better than paper or online
• How to adapt the documentation process to the requirements of individual projects and build in change
• How to organise documents and make them easily accessible
• When to use diagrams rather than text
• How to choose the right tools and techniques
• How documentation impacts the customer

Better than offering pat answers or prescriptions, this book will help you to understand the elements and processes that can be found repeatedly in good project documentation and which can be shaped and designed to address your individual circumstance. The author uses real-world examples and utilises agile principles to provide an accessible, practical pattern-based guide which shows how to produce necessary and high quality documentation.