Guido van Rossum writes: > On Sun, Sep 22, 2013 at 5:31 PM, Steven D'Aprano <st...@pearwood.info> wrote:
>> My own preference is to err on the side of too much rather than >> too little, since I live by help() and only fall back on the web >> documentation when I really must. > I guess preferences differ. Indeed. Abstractly I agree with Steven: there are some modules such as statistics where it would be nice for users to have long docstrings that might even be the full source for the web docs if the module author so prefers. But given that Python has an existing policy of concise docstrings (which indeed is useful when browsing code) and a separate manual, I withdraw my support for changing practice. (Sorry, Steven.) _______________________________________________ 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
