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).