Agile Documentation

From Pearl Language
Revision as of 16:29, 11 February 2012 by Martien (talk | contribs) (Typo.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


Scott Ambler distinguishes three types of documentation:

  1. keepers;
    • documents that always need to be up-to-date (should appear in ready to ship;
  2. update when it hurts:
    • documents are only updated when the burden of outdatedness outweigh and justify the effort of getting it up-to-date; e.g. architecture documents can linger for a while
  3. never
    • documents that you never update (consider removing them altogether)

Toss every document that you plan to make in one of these bins. Then reconsider creating them at all.

Documentation principle: Do not create documentation unless:

  1. legally required;
  2. of key value to any of the stakeholders (be explicit about the stakeholder(s) and the document's value).

See: