Ieri ho perso parecchio tempo alla ricerca di un modo per documentare le api del Polygen, il progetto al quale lavoriamo in ufficio. Navigando mi sono imbattuto nel famosissimo phpDocumentor, uno strumento che genera documentazione parsando il codice sorgente. Lo strumento è anche incluso in pear, la libreria per eccellenza di php.
Tuttavia questo pacchetto non era ciò che cercavo, desidero scrivere manualmente a mio piacimento la documentazione del Polygen! (si, lo so, sono pazzo).
Così ho scoperto un po di cose nuove sulle modalità di fare documentazione, su come viene prodotta la documentazione nei progetti open source e sugli standard.
Iniziamo subito dicendo che l'argomento "standard" viene troncato...
Leggi il seguito »
