On 01/08/2019 19:11:18, Guido van Rossum wrote:
Here is someone declaring that the docs are less accessible than the
code. I personally am disappointed, given the amount of effort that we
put in those docs. But maybe this is true. If we can't get people to
peruse the docs, should we bother?
One data point: I constantly use the docs and help(). I regard digging
into the code as more effort and a second resort. I'm well aware from
personal experience that documenting code can be (much) more effort than
writing it, but I hope you continue to "bother".
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at
https://mail.python.org/archives/list/python-ideas@python.org/message/SH4NU6INGJFNPEJYCKS7RDWJ5S2FJU7I/
Code of Conduct: http://python.org/psf/codeofconduct/