Il source va commentato?

AdSum (16290 points)
9 20 134
asked Oct 24, 2020 in HW2 obbligatorio by AdSum (16,290 points)
So che bisogna scrivere un program01.txt contenente lo pseudocodice e tutto il resto. Il mio dubbio è riguardo il source: devo commentare le varie righe di codice spiegando sommariamente il funzionamento e lo scopo oppure non è necessario e posso lasciare il source "privo di documentazione"?

1 Answer

Best answer
Valerio Cucchiaro (1900 points)
1 2 9
answered Oct 24, 2020 by Valerio Cucchiaro (1,900 points)
selected Oct 24, 2020 by AdSum
No, i commenti nel source non sono obbligatori, servono a te, o a qualcuno che deve leggere il tuo programma, per capire meglio il codice.
andrea.sterbini (172780 points)
513 935 1789
commented Oct 24, 2020 by andrea.sterbini (172,780 points)
E' buona regola inserire quel minimo ci commenti necessari a spiegare il codice se non è self-explanatory.

L'anno prossimo ci sarà un terzo bonus per i programmi più leggibili.