[Php-it] [semi-ot] Programmazione

[Giovanni Battista Lenoci]

Gianluca Baù ha scritto:
> Salve ragazzi,
> una domanda un po' generica sul vostro metodo di lavoro.
>
> Voi tenete una documentazione (cartacea/digitale) su un lavoro (da 
> mediamente complesso in su) che state portando avanti ?
> La aggiornate periodicamente? Come la strutturate?
>
> Nel senso:
>
> Sezione --> cosa fa --> variabili coinvolte ? --> funzioni ? --> files 
> inclusi ? --> boh ?
>
> Io ho provato tante volte a farlo ma sfortunatamente mi pesa molto 
> dover riaggiornare la documentazione ogni volta che cambio qualcosa.
>
> E poi, in ogni file che scrivete inserite delle intestazioni su quello 
> che fa, che variabili deve ricevere, etc... ? Una specie di /* 
> OVERVIEW: */ intendo.
>
>
Generalmente documento le classi, usando la sintassi di javadoc, cosi 
che se dovessi averne bisogno potrei generare la documentazione con phpdoc.

Chissa perchè non riesco a farlo nei file che includono le classi, tendo 
a documentare solo le cose un po' più "strane".

Ciao


-- 
gianiaz.net
di Giovanni Battista Lenoci 
P.le Bertacchi 66 
23100 Sondrio
cell. +39.392.7096936
cell. +39.347.7196482