Mettere i commenti nel codice è sicuramente utile ma spesso insufficiente.
Si rende quindi necessario creare a parte una dcumentazione tecnica.
Mi piacerebbe poter inserire nel codice, in cima, un collegamento cliccabile del tipo:
http://localhost/doctecnica?arg=anagrafe&sub=pariva
in modo che chiunque possa andarsi a leggere le spiegazioni in chiaro della procedura.