         <p>Bad</p>
        </blockquote>

        <pre><code>def example(y):
    x += 1            # increments x by 1
    return square(x)  # returns the square of x</code></pre>

        <p>Your actual code should be <em>self-documenting</em> -- try to make it as
          obvious as possible what you are doing without resorting to
          comments. Only use comments if something is not obvious or needs to
          be explicitly emphasized.</p>


        <h2 id="repetition">Repetition</h2>


        <