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-leave@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/