Re: RFC: How best to provide examples for newbies

[Araq]

You're missing that RST supports `.. include:: moredocs.rst`. So we can keep 
the doc comments slim and yet can add many more examples for every proc in the 
stdlib. :)