Ciao ragazzi.. essendo un pignolo e aspirando alla perfezione, o ciò che più si avvicina, per un progettino per l'uni (in C.. ma credo non importi molto per il discorso ).. mi ponevo due dubbi:


Come andrebbe documentata coi commenti una funzione?
Innanzitutto meglio documentarla contestualmente alla dichiarazione dei prototipi, contestualmente all'implementazione, o in entrambe i posti?

in secondo luogo come va commentata una funzione? breve descrizione di ciò che fa, dei valori ricevuti e di quello restituito... giusto? altro?

Per il resto quali altri commenti non devono assolutamente mancare (a parte quelli suoi blocchi di codice meno banali )???

Le variabili dichiarate le commento tutte o solo quelle più oscure?
tipo se ho una variabile "i" io ci metterei "contatore che server per..." mentre una variabile "pid" di tipo "t_pid" dovrebbe essere abbastanbza intuitiva..


scusate la pignoleria