Aktuálně ve Forrestu revidujeme způsob vytváření
dokumentace, nastavení standardů a bavíme se o tom,
co a jak změnit.

Motiv je jasný – nejsme spokojeni se současným
stavem a v některých případech dokonce dost zásadně.
Všichni známe to staré rčení “nejlepší dokumentace je
zdrojový kód”, které pochází kdoví odkud (tipnul bych
si, že za ním stojí eXtreme Programming, ale zdroj
jsem vážně nenašel) – jenže je to omyl. Správná
dokumentace může mít dost zásadní vliv na výslednou
použitelnost / publicitu vašeho produktu / knihovny
mezi programátory.

Kvalitní (systém) dokumentace má podle mého názoru
zásadní pozitivní vliv na rozšíření např.jQuery nebo Springu. Naopak negativně se musela dokumentace
podepsat na adopci Groovy. Přestože se jedná o skvělý jazyk,
dokumentace je na tom, co se týká přehlednosti a
detailnosti, bídně (můj subjektivní dojem).