> From: gvanros...@gmail.com [mailto:gvanros...@gmail.com] On Behalf Of Guido > van Rossum > Sent: Sunday, September 22, 2013 11:35 AM > > You seem to misunderstand the use of "autogeneration". It refers to generating > the .rst docs from the docstrings in the source. And FWIW, I'm against that > practice.
Oh I see. Well in that case, the docstrings can still become outdated, and so then the .rst docs will be outdated, too. It doesn't seem to offer much benefit since you still have to keep both updated, plus you have an extra tool that must be maintained. _______________________________________________ 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
