[OT] Convenzioni per commentare il codice

[Downloader]

Vorrei sapere se esistono delle convenzioni per quanto riguarda i commenti del codice sorgente, oppure se tutto è lasciato al programmatore.
Nel caso sia tutto lasciato al programmatore, avete dei consigli su come scrivere i commenti?
Ad esempio dove scriverli, il grado di astrazione da usare quando si spiega cosa si sta facendo, etc etc.

Grazie

[Downloader]

up

[alka]

Esistono senz'altro delle convenzioni molto generali, però per fornire indicazioni più mirate credo sia necessario specificare anche il linguaggio.

[Downloader]

Grazie della risposta.

In generale mi interesserebbero quelle del C e di Java.

[XWolverineX]

Convenzioni anche nel commentare??

[alka]

Per quanto riguarda Java, credo sia proficuo seguire le indicazioni legate all'uso del tool Javadoc descritte in questo articolo.

[MItaly]

Per quanto non sia d'accordo su diversi punti della "Guida di stile" di Google, è sempre un buon riferimento.
http://google-styleguide.googlecode....e.xml#Comments

[Downloader]

Ok, grazie.