<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Sun, Sep 22, 2013 at 2:41 PM, Xavier Morel <span dir="ltr"><<a href="mailto:python-dev@masklinn.net" target="_blank">python-dev@masklinn.net</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">The points here are that there's a single source of truth (so we can't<br>
have conflicting docstring and rst documentation), and documentation<br>
becoming outdated can be noticed from both docstring and published<br>
documentation.<br></blockquote></div><br></div><div class="gmail_extra">Another case of DRY madness.<br><br></div><div class="gmail_extra">It seems too many programmers see documentation as unpleasant red tape they want to cut through as quickly as possible, instead of an opportunity to communicate with their *users*. To the contrary: users should be the most important people in the world if you're writing code that's worth documenting at all.<br clear="all">

</div><div class="gmail_extra"><br>-- <br>--Guido van Rossum (<a href="http://python.org/~guido">python.org/~guido</a>)
</div></div>