Commenti a: Commentare il codice sorgente, è inutile?

Di: Cesare

Cesare — Fri, 16 Apr 2010 09:09:36 +0000

Ottimi consigli, aggiungo che talvolta troppi commenti rendono anche meno leggibile il codice per via delle continue interruzioni!

PS: questo blog è molto interessante, è già entrato nei miei segnalibri

Di: Namaless

Namaless — Sun, 29 Nov 2009 00:07:09 +0000

Ritengo che commentare il codice sorgente sia importante, quanto meno rispettare lo standard qualora si decide di utilizzare dei sistemi automatizzati per trarre delle sotto-specie di documentazione (vedi phpDoc).

Per quanto riguarda lo sviluppo in team ritengo che siano obbligatori come suggeriva appunto Lorenzo. Per applicazioni sviluppate e mantenute da me lo commento ugualmente in quanto passato del tempo devi rileggere ogni metodo, invece con i commenti messi al posto giusto non hai necessità.

Io comunque per comprendere meglio il codice mi scrivo di solito delle mini-libs che mi permettono di ricordare cosa fanno, del tipo Session::flash() oppure Pagination::factory(), ecc…

Di: Lorenzo

Lorenzo — Sun, 11 Oct 2009 10:30:55 +0000

Bah, se fai così, spero proprio di non lavorare mai con te in un progetto! Altrimenti sarebbe davvero complicato capire quel che vuoi fare senza nemmeno una riga di commento.

Per me commentare il codice nn è importante solo in un contesto open source ma anche in un progetto in cui siamo più collaboratori, più programmatori insieme: anche per un passaggio d consegne diviene tutto molto più facile se il codice scritto è chiaro e lineare.

Non sei d’accordo?

Di: Lino

Lino — Sat, 10 Oct 2009 17:37:49 +0000

Io penso che commentare il codice per favorire gli altri sia una bella cazzata.. in una logica Open Source forse.. ma lo scenario di un programmatore non è sempre open source, anzi.. Io non commento niente, anzi, cerco di incasinare tutto il più possibile, così se c’è necessità di modifiche al progetto i soldi li prndo io prendo io, perchè un’altro non ci capirebbe nulla..

Di: Lorenzo

Lorenzo — Thu, 24 Sep 2009 12:57:06 +0000

Bah ci insegnano sempre a noi programmatori che il codice va commentato. Ed io sono d’accordo con questa politica, senza però esagerare ma inserendo i giusti commenti che spiegano a grandi linee cosa si sta cercando di fare.

Ritengo questo comportamento molto utile, sia nel caso in cui il codice finisca in mani di terzi diverse da quelle dell’autore, sia nel caso in cui l’autore stesso abbia la necessità di rimaneggiare il codice dopo molto tempo, magari anche dopo qualche anno.
Credo che serva molto commentare. E non porta via tempo se mentre scrivi il codice aggiungi una riga dove spiega cosa fa.