<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">2015-08-20 14:47 GMT+02:00 enrico franchi <span dir="ltr"><<a href="mailto:enrico.franchi@gmail.com" target="_blank">enrico.franchi@gmail.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><span><br><div class="gmail_quote">2015-08-20 10:24 GMT+01:00 orciml <span dir="ltr"><<a href="mailto:orciml@gmail.com" target="_blank">orciml@gmail.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="overflow:hidden">il link del nuovo blog è il seguente:<br>
<br>
<a href="http://orcim.github.io" rel="noreferrer" target="_blank">orcim.github.io</a></div></blockquote></div><br></span>Mi sono permesso di lasciarti un commento... </div></div></blockquote><div><br></div><div>Cito qui quello che dice Enrico:</div><div><br></div></div></div><blockquote style="margin:0 0 0 40px;border:none;padding:0px"><div class="gmail_extra"><div class="gmail_quote"><div><i>"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".</i></div></div></div></blockquote><div class="gmail_extra"><div class="gmail_quote"><div><br></div><div>Devo dire che anche io, una volta, pensavo che i commenti fossero necessari e più ce n'erano meglio era.</div><div><br></div><div>Poi lessi questa frase nel libro Clean Code:</div><div><br></div></div></div><blockquote style="margin:0 0 0 40px;border:none;padding:0px"><div class="gmail_extra"><div class="gmail_quote"><div><i>"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".</i></div></div></div></blockquote><div class="gmail_extra"><div class="gmail_quote"><div><br></div><div>Ok, è un po' radicale ma, per la miseria, c'è tanta ragione.</div><div><br></div><div>Invece di scrivere codice così;</div><div><br></div><div>    # Incremento il numero della fattura</div><div>    n += 1</div><div><br></div><div>Dobbiamo scrivere codice che si documenta da solo:</div><div><br></div><div><div>    numero_fattura += 1</div><div><br></div></div><div>In questo modo non potrà esiste un commento che si allontana dal codice, diventando così più un danno che un vantaggio.</div><div><br></div><div>Ciao.<br>Marco.</div><div><br></div></div>-- <br><div><div dir="ltr"><div><div><a href="http://beri.it/" target="_blank">http://beri.it/</a> - Un blog</div><div><a href="http://beri.it/i-miei-libri/" target="_blank">http://beri.it/i-miei-libri/</a> - Qualche libro</div><div><span style="font-size:small"><a href="http://beri.it/articoli/" target="_blank">http://beri.it/articoli/</a> - Qualche articolo</span></div></div></div></div>
</div></div>