Čo presne chcete vidieť v pláne dokumentácie a ako by ste ho zostavili?

Čo sa týka dokumentácie, je dôležité vidieť:

• Ciele a úlohy projektu — aby sme pochopili, prečo sa systém vytvára.
• Požiadavky — funkčné a nefunkčné, jasne opísané a overiteľné.
• Architektúra systému — hlavné komponenty, ich vzájomná interakcia, používané technológie.
• Obchodné procesy a scenáre použitia — aby sme videli, ako bude systém v praxi využívaný.
• Diagramy a modely — UML diagramy, ER diagramy, schémy tokov dát pre prehľadnosť.
• Technické detaily — API, formáty dát, obmedzenia.

Je lepšie dokumentáciu budovať iteratívne, začínajúc s vysokou úrovňou popisov a postupne sa hlbšie venovať detailom. Je dôležité ju udržiavať aktuálnu a integrovať do vývojového procesu (napríklad cez wiki, systémy správy požiadaviek alebo automatickú generáciu z kódu).