RetroSearch Browse

Sun Sep 22 13:05:14 CEST 2013 · https://mail.python.org/pipermail/python-dev/2013-September/128842.html

On 2013-09-22, at 12:16 , Nick Coghlan wrote:
> 
> It's a bit of a pain, and we do occasionally get bug reports where the
> docstrings get out of date, but it's the least bad of the currently
> available options.

Is it really less bad than allowing limited fine-grained use of autodoc?
Not necessarily class-level and definitely not module-level, but
function- and method-level autodoc could allow avoiding duplication and
make it clearer that the prose and docstrings are getting out of sync.

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

Showing content from https://mail.python.org/pipermail/python-dev/2013-September/128842.html below:

[Python-Dev] Best practice for documentation for std lib