[Php-it] [semi-ot] Programmazione

[Gianluca Baù]

Cristiano Verondini wrote:

>
>> Generalmente documento le classi, usando la sintassi di javadoc, cosi
>> che se dovessi averne bisogno potrei generare la documentazione con
>> phpdoc.
>
>
>    Questa è (sarebbe) un'ottima pratica.
>
>> Chissa perchè non riesco a farlo nei file che includono le classi,
>> tendo a documentare solo le cose un po' più "strane".
>
>
>    La documentazione è sempre un problema nei progetti software. Chi 
> scrive codice è abituato a pensare alla documentazione come 'tempo 
> inutile', ma in realtà quando si lavora su progetti medio-grandi, è 
> molto di più il tempo speso a documentare il codice che non quello 
> speso a realizzarlo.
>
>    Ovviamente il progetto deve partire da una nutrita serie di 
> requisiti tecnici, analisi e quant'altro, che già da soli dovrebbero 
> costituire abbondante documentazione. Nel software si dovrebbero 
> documentare le interfacce (e qui javadoc/phpdoc è ottimo) e poi 
> qualche processo, ma soprattutto, come dici tu, le cose più 'strane'.
>
>        Cris
>
Il mio problema principale è che sicuramente sbaglio l'approcio ad un 
nuovo progetto, o meglio, mi trovo in situazioni dove quello che deve 
essere fatto non è preventivamente ben definito ma viene fuori passo passo.
Questo rende difficile stilare un progetto completo da realizzare e 
successivamente da mantenere.

A voi capita di avere lavori che richiedono praticamente ogni giorno 
nuove funzionalità che magari il giorno prima non avreste neanche 
immaginato di dover inserire?

Mi sto cimentando da un po' di tempo nella realizzazione di un 
gestionale interno alla mia azienda.
Il progetto si sta ingrandendo parecchio e per la prima volta mi trovo a 
scontrarmi con un codice così "ampio" dove mi capita di scordarmi cosa 
fa un modulo o meglio com'è stato progettato quando
è un po' che non ci metto mano.

Credo proprio che comincerò a mettere un'instezione in ogni file 
specificando cosa fa e che variabili deve ricevere.

Inoltre volevo chiedere: all'inizio di ogni script, fate una 
dichiarazione globale di tutte le variabili che userete ?? O le lasciate 
al caso durante la scrittura del codice?

Gianluca