Merge pull request #184 from alcy/sidenotes-and-sections

Add note about section tags for sidenotes

index.html

@@ -78,6 +78,7 @@ <h2 id="sidenotes">Sidenotes: Footnotes and Marginal Notes</h2>
        class="margin-toggle"/&gt;</code></pre>
         <p>You must manually assign a reference <code>id</code> to each side or margin note, replacing “sn-demo” in the <code>for</code> and the <code>id</code> attribute values with an appropriate descriptor. It is useful to use prefixes like <code>sn-</code> for sidenotes and <code>mn-</code> for margin notes.</p>
         <p>Immediately adjacent to that sidenote reference in the main text goes the sidenote content itself, in a <code>span</code> with class <code>sidenote</code>. This tag is also inserted directly in the middle of the body text, but is either pushed into the margin or hidden by default. Make sure to position your sidenotes correctly by keeping the sidenote-number label close to the sidenote itself.</p>
+        <p>For optimal readibility of sidenotes, enclose the main text in the <code>section</code> tag.</p>
         <p>If you want a sidenote without footnote-style numberings, then you want a margin note.
           <label for="mn-demo" class="margin-toggle">&#8853;</label>
           <input type="checkbox" id="mn-demo" class="margin-toggle"/>