GeezerVison

I just noticed that the exception chaining PEP (3134) links to this python-dev post:
https://mail.python.org/pipermail/python-dev/2003-January/032492.html
which suggested to make it possible to append to the exception message instead of overwrite it (when raising). The reply suggests to attach the previous exception as the cause of the new one instead, which was recognised as the better approach.

In terms of guidelines for when to use chaining and when to use notes, maybe it goes back to this - are we about to re-raise the exception (then we chain) or are we doing something else with it, like storing it for later or grouping it in an ExceptionGroup, and then we add a note.

OK, I'm finished this PR and - unless anyone has further feedback here - will be ready to post to python-dev early next week 😁

unless anyone has further feedback here - will be ready to post to python-dev early next week 😁

I imagine the SC will appreciate this being submitted ahead of the PEP rush leading up to the feature freeze.

Sorry I didn't get a chance to re-review -- looks good though, thanks @Zac-HD & @iritkatriel!
A

@AA-Turner Thank you for your review. I went ahead and merged so @Zac-HD can post it, but it's still a draft so we can fix things in future PRs. Let us know if you see anything.

Looks good as well, thanks! Per #2130 , you could consider converting the references from footnotes to actual link targets and just directly linking the appropriate text in the body (aside from the one that is an actual footnotes), to make them much easier to follow for readers. E.g. subject to `breakage without warning`_ and in the References/Footnotes section,

.. _breakage without warning: https://example.com

Or, you could give the link target a short name instead, e.g. breakage, and reference it like this: subject to `breakage without warning <breakage_>`_.

But, to be clear, you don't have to do that if you don't want, if you feel it creates too much churn. Or I'm happy to open a PR for you.

🙏 Thanks so much to everyone for you feedback and fixes - the document is so much better than it would be without you!

@CAM-Gerlach - I've really just imitated other PEPs here; my impression is that the use of footnotes is mostly for ease of reading in e.g. mail clients which don't support HTML or RST markup. That does seem like more of a historical concern, but I'm hesitant to break with tradition in my first PEP 😅

use of footnotes is mostly for ease of reading in e.g. mail clients which don't support HTML or RST markup. That does seem like more of a historical concern

I think ease of reading on the web is far more important -- a lot of recent edits to various PEPs have included inlining links. Appreciate the concerns, though!

A