<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><br><div><div>On Mar 16, 2012, at 4:54 AM, Nick Coghlan wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><span class="Apple-style-span" style="border-collapse: separate; font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; font-size: medium; ">Don't forgot you also have the option of splitting out a separate<br>HOWTO tutorial section, leaving the main docs as a pure API reference.<br>(I personally find that style easier to use than the ones which try to<br>address both needs in the main module docs).</span></blockquote></div><br><div>+1</div><div><br></div><div>The commingling of extensive examples with regular docs has</div><div>made it difficult to lookup functionality in argparse for example.</div><div>In contrast, the logging module's howtos were split-out to good effect.</div><div><br></div><div><br></div><div>Raymond</div></body></html>