[Python] nuovo Blog

[orciml]

On 20/08/2015 15:43, Marco Beri wrote:
> 2015-08-20 14:47 GMT+02:00 enrico franchi <enrico.franchi a gmail.com 
> <mailto:enrico.franchi a gmail.com>>:
>
>
>     2015-08-20 10:24 GMT+01:00 orciml <orciml a gmail.com
>     <mailto:orciml a gmail.com>>:
>
>         il link del nuovo blog è il seguente:
>
>         orcim.github.io <http://orcim.github.io>
>
>
>     Mi sono permesso di lasciarti un commento...
>
>
> Cito qui quello che dice Enrico:
>
>     /"In generale, non e' vero che commentare *molto* sia una buona
>     idea. L'idea buona e' rendere necessario commentare poco. I
>     commenti storicamente finiscono fuori sincrono con il codice,
>     specialmente quelli ridondanti e poco utili"./
>
>
> Devo dire che anche io, una volta, pensavo che i commenti fossero 
> necessari e più ce n'erano meglio era.
>
> Poi lessi questa frase nel libro Clean Code:
>
>     /"The proper use of comments is to compensate for our failure to
>     express ourself in code. Comments are always failures. We must
>     have them because we cannot always figure out how to express
>     ourselves without them, but their use is not a cause for
>     celebration. So when you find yourself in a position where you
>     need to write a comment, think it through and see whether there
>     isn’t some way to turn the tables and express yourself in code"./
>
>
> Ok, è un po' radicale ma, per la miseria, c'è tanta ragione.
>
> Invece di scrivere codice così;
>
>     # Incremento il numero della fattura
>     n += 1
>
> Dobbiamo scrivere codice che si documenta da solo:
>
>     numero_fattura += 1
>
> In questo modo non potrà esiste un commento che si allontana dal 
> codice, diventando così più un danno che un vantaggio.
>
> Ciao.
> Marco.
>
> -- 
> http://beri.it/ - Un blog
> http://beri.it/i-miei-libri/ - Qualche libro
> http://beri.it/articoli/ - Qualche articolo
>
>
> _______________________________________________
> Python mailing list
> Python a lists.python.it
> http://lists.python.it/mailman/listinfo/python
Scusa per la fretta di ieri.

Sono d'accordo con te in linea di massima.

Le mie labels però non sono mai di una lettera, (almeno 4).
I commenti di soliti descrivono un'insieme di operazioni.
A meno di non spiegare delle funzioni che si richiamano nella riga 
stessa che hanno a volte dei nomi non tanto menmonici.
Per me restano fondamentali per rendere il codice più leggibile e 
gestibile a distanza di tempo.

Ciao Loris
-------------- parte successiva --------------
Un allegato HTML è stato rimosso...
URL: <http://lists.python.it/pipermail/python/attachments/20150821/e560a0a5/attachment-0001.html>