• I removed the duplicate example; it should be sufficient to provide a single example.
• Use note:: to put emphasis on non-standard reference count semantics in the set function.
• Mark the getter as returning a borrowed reference.
• Apply Diátaxis: be succinct and to the point (and hopefully also clearer)

Thanks @erlend-aasland ; this is a substantial improvement to the previous docs.

Thanks, and thanks for the review!

Perhaps its worth fixing the other couple remaining similar docs defects also introduced in PR #101607 , namely in the descriptions of the newly documented functions PyException_GetArgs and PyException_SetArgs (that could use a similar (if much simpler) treatment as here), and the deprecation notices added to PyErr_Fetch, PyErr_Restore and PyErr_NormalizeException not being added to, and particularly duplicating, the .. deprecated directive.

Definitely; perhaps as a follow-up PR?

Definitely; perhaps as a follow-up PR?

Yeah certainly could be; up to you, of course

Thanks for the review, CAM; highly appreciated. I'll wait for @iritkatriel's or @markshannon's approval before landing.

Thanks for the reviews, Irit and CAM; highly appreciated. I'll create a follow-up PR Any Time Soon™.