RetroSearch Browse

Sun Jul 24 19:23:39 CEST 2005 · https://mail.python.org/pipermail/python-dev/2005-July/054931.html

On 7/24/05, Tim Peters <tim.peters at gmail.com> wrote:
> I'm sure there is <wink>, but via a different route:  tools to extract
> text from the full documentation, not to burden docstrings with an
> impossible task.  Channeling Guido, docstrings are best when they have
> a "quick reference card" feel, more memory aid than textbook.  That
> doesn't mean it wouldn't also be nice to have "the textbook" online
> from pydoc/help too, it means that manuals and docstrings serve
> different purposes.

While I agree that docstrings shouldn't be a deep copy of _Python in a
Nutshell_, there are definitely some areas of the standard library
that could use some help.  threading comes to mind immediately.
-- 
Tim Lesher <tlesher at gmail.com>

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://mail.python.org/pipermail/python-dev/2005-July/054931.html below:

[Python-Dev] should doc string content == documentation content?