On 22 September 2013 13:54, Eli Bendersky <eli...@gmail.com> 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.
While I agree entirely with this, it's worth noting that with the increasing popularity of IPython (even outside of the scientific community), more and more people are becoming used to using docstrings as a first means of finding out about a function's behaviour. Paul _______________________________________________ Python-Dev mailing list Python-Dev@python.org https://mail.python.org/mailman/listinfo/python-dev Unsubscribe: https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
