The correct place for the docs for __cause__ and __context__ is in the section in the library reference about exceptions. There's quite a bit about them there already. That's where the tutorial should link as well.

And now I ask you to stop complaining (your "the PEPs are the worst" does not help your cause).

On Thu, Nov 12, 2020 at 12:30 PM Riccardo Polignieri via Python-Dev <python-dev@python.org> wrote:

> There is value in having non-trivial coverage of the language. When people ask how
> __cause__ works, we can link to the tutorial.

I don't necessarily agree with the rest, but I think this is very important - at least, in the
current situation. Maybe in the future we will be able to rearrange and move some parts
of the tutorial into the "how to" section, and/or to write more introductions to the various
sections of the documentation... but for now, the tutorial is all we have.

> Otherwise, we have to throw them to the
> wolves by linking to the unfriendly, highly technical reference guide or to a PEP.

Indeed. The PEPs are the worst, more often than not. I remember when I first learned Pyhton,
every time the documentation linked to a PEP, I felt a shiver down my spine.

r.
_______________________________________________
Python-Dev mailing list -- python-dev@python.org
To unsubscribe send an email to python-dev-leave@python.org
https://mail.python.org/mailman3/lists/python-dev.python.org/
Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/LHGZNTRKU2Z2OD3W7DPFEDS274OBFE7F/
Code of Conduct: http://python.org/psf/codeofconduct/