Wow, super helpful response. On Mon, Apr 12, 2021 at 1:26 PM Brendan Barnwell <brenb...@brenbarn.net> wrote:
> On 2021-04-12 03:13, Stéfane Fermigier wrote: > > The public API of a library is the one which is documented as > > such. > > > > > > Right, except that in practice: > > > > 1) Many useful libraries are not documented or properly documented. > > Then they're buggy. I'm not convinced by the argument that "in > practice" people do things they shouldn't do and that therefore we > should encourage them to do more of that. > > > 2) People don't read the docs (at least not always, and/or not in > details). > > Insofar as someone relies on behavior other than that given in the > docs, they are being foolish. Again, I'm not convinced by the argument > that "in practice" people do foolish things and that therefore we should > encourage them to do more of that. > > -- > Brendan Barnwell > "Do not follow where the path may lead. Go, instead, where there is no > path, and leave a trail." > --author unknown > _______________________________________________ > 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/DWI2MI3FRPRNOC7AS6CC3YBWLOOVZYZA/ > Code of Conduct: http://python.org/psf/codeofconduct/ > -- --Guido van Rossum (python.org/~guido) *Pronouns: he/him **(why is my pronoun here?)* <http://feministing.com/2015/02/03/how-using-they-as-a-singular-pronoun-can-change-the-world/>
_______________________________________________ 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/F57J672KTTK6FRA7ITRUVTRYBF2A3P57/ Code of Conduct: http://python.org/psf/codeofconduct/