Sept. 22, 2013
5:07 p.m.
On Sun, Sep 22, 2013 at 05:54:57AM -0700, Eli Bendersky wrote:
IMHO the right way to think about it is that the .rst files are by far the more important documentation. Sometimes we forget that most Python programmers are people who won't go into the source to read docstrings.
Docstrings are never more than one command away in the interactive interpreter: help(some.function) If you're going to the source to read docstrings, you're doing it wrong :-) I always go for interactive help first, and the web docs second. The only reason I go to the source is to read the source *code*, not the docstrings. -- Steven