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.
