[OT] Importanza dei commenti nel codice sorgente

[XWolverineX]

I commenti nel vostro codice sono fondamentali?
Io non ho mai commentato niente eppure mi trovo bene

[alka]

Manca l'opzione intermedia e forse la più equilibrata: i commenti sono importanti quanto servono.

[unomichisiada]

Originariamente inviato da alka
Manca l'opzione intermedia e forse la più equilibrata: i commenti sono importanti quanto servono.

Naturalmente sono d'accordo. Vanno messi quando il codice è complesso e possono aiutare nella comprensione, se ne può far e meno se il codice si spiega da se. Inutile dire che questa seconda situazione si realizza tanto più spesso quanto più il programmatore scrive buon codice. In particolare seguire le convenzioni stilistiche sulla denominazione delle variabili o cose del genere costituisce una buona parte dello scrivere buon codice. Per riassumere il codice dovrebbe essere scritto in maniera tale da speigarsi da se per quanto riguarda gli aspetti puramente legati al linguaggio ed i commenti dovrebbero essere riservati a spiegare il sottostarto algoritmico comune a tutti i linguaggi o al limite la funzione di qualche parametro oscuro o casi particolari di qualunque tipo.

[LeleFT]

Sono d'accordo con quanto hanno scritto coloro che hanno risposto prima di me.
Però c'è da tenere in considerazione un altro aspetto: il codice che scrivo io, nella maggior parte delle volte, dovrà essere ripreso in mano da una persona diversa a distanza di tanto tempo.
Questo significa che dal momento in cui io scrivo del codice che funziona al momento in cui una terza persona dovrà metterci le mani, le cose possono essere drasticamente cambiate (parlo a livello di organizzazione del lavoro, come politiche aziendali, usanze fra i programmatori di uno stesso team, ecc.). Questo porta molto spesso a incomprensioni: un codice che 10 anni fa era chiarissimo, potrebbe non esserlo oggi (e quasi mai lo sarà!).
Ecco che i commenti sono importanti.

Per non parlare del fatto che ci sono linguaggi che, per loro natura, non permettono di avere "codice autoesplicante". Regole sintattiche differenti permettono la realizzazione di codice decisamente diverso, anche se algoritmicamente identico (qui parlo per esperienza diretta): se si pensa che a tutt'oggi vengono ancora utilizzati linguaggi che non permettono alle variabili di avere nomi più lunghi di 8 caratteri...


Ciao.

[XWolverineX]

I nuovi IDE della microsoft, nel C# facilita la scrittura di commenti con i summary ed i region
In C++ invece siamo ancora con i // e /**/
Dovrebbero introdurre queste innovazioni anche negli Ide C++, anche se forse vanno contro lo standard(anche se ci sono già andate con loro particolari parole-chiave)

[alka]

Originariamente inviato da XWolverineX
I nuovi IDE della microsoft, nel C# facilita la scrittura di commenti con i summary ed i region
In C++ invece siamo ancora con i // e /**/

Quelle non sono facilitazioni per i commenti, ma solo espedienti per poter inserire la documentazione delle classi direttamente nel codice per raccoglierla poi con un tool esterno che genera l'apposito file consultabile in diversi formati.

Le "regioni" invece sono progettate ad un altro scopo, cioè rendere collassabile una porzione di codice; principalmente, sono state introdotte per risolvere il problema di togliere dalla vista il codice che viene generato automaticamente dal framework durante la progettazione di un'applicazione.
All'esterno di questo frangente, pur essendo uno strumento utilizzabile, in genere vi sono linguaggi che prevedono forme più navigabili del codice (ad esempio, attraverso dichiarazioni specifiche) senza specificatamente obbligare il programmatore a collassarsi l'intero codice o a creare regioni per poter navigare il file in modo decente.

Ciao!

[spedizione123]

I commenti sono fondamentali , aiutano anche nella generazione automatica di documentazione, come ad esempio doxygen.

Ciao a tutti ed usate sempre commenti, sono utilissimi (naturalmente non per le cose banali).