<html>
  <head>
    <meta content="text/html; charset=windows-1252"
      http-equiv="Content-Type">
  </head>
  <body bgcolor="#FFFFFF" text="#000000">
    <div class="moz-cite-prefix">On 20/08/2015 15:43, Marco Beri wrote:<br>
    </div>
    <blockquote
cite="mid:CAN1J36gDrMbbCoLdHHORmCpE+S-v_Xpp-owYDNnBTov294b09g@mail.gmail.com"
      type="cite">
      <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 moz-do-not-send="true"
                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
                          moz-do-not-send="true"
                          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 moz-do-not-send="true"
                            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 moz-do-not-send="true" href="http://beri.it/"
                    target="_blank">http://beri.it/</a> - Un blog</div>
                <div><a moz-do-not-send="true"
                    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
                      moz-do-not-send="true"
                      href="http://beri.it/articoli/" target="_blank">http://beri.it/articoli/</a> -
                    Qualche articolo</span></div>
              </div>
            </div>
          </div>
        </div>
      </div>
      <br>
      <fieldset class="mimeAttachmentHeader"></fieldset>
      <br>
      <pre wrap="">_______________________________________________
Python mailing list
<a class="moz-txt-link-abbreviated" href="mailto:Python@lists.python.it">Python@lists.python.it</a>
<a class="moz-txt-link-freetext" href="http://lists.python.it/mailman/listinfo/python">http://lists.python.it/mailman/listinfo/python</a>
</pre>
    </blockquote>
    Scusa per la fretta di ieri.<br>
    <br>
    Sono d'accordo con te in linea di massima.<br>
    <br>
    Le mie labels però non sono mai di una lettera, (almeno 4).<br>
    I commenti di soliti descrivono un'insieme di operazioni.<br>
    A meno di non spiegare delle funzioni che si richiamano nella riga
    stessa che hanno a volte dei nomi non tanto menmonici.<br>
    Per me restano fondamentali per rendere il codice più leggibile e
    gestibile a distanza di tempo.<br>
    <br>
    Ciao Loris<br>
  </body>
</html>