GeezerVison

All commit authors signed the Contributor License Agreement.

I see that at least three people have put in effort here, but it's stalled. I can carry it forward, if that seems appropriate.

@StanFromIreland , as the most recent reviewer, what would you think of me picking this up and continuing the work in a new PR?
(I'd preserve these commits, but open a fresh PR with my additions.)

@sirosen yes, it would be great for someone to pick this up, this has been stale for a while. I would suggest that whoever does pick it up do at least one deprecation in CPython beforehand. I think part of the issue here was that current practices aren't written down, which made it easy to end up inventing new ones. If you have any questions while working on this, feel free to ask/ping me.

Other things worth covering here would be soft deprecations. I also wouldn't focus too much on the "When to deprecate?" section, that's a difficult topic and all cases can't be covered by the docs, some general guidelines would suffice. In the future we could also expand the section to cover removing the deprecated items, as this gets difficult e.g. when things are in the stable ABI.

And might be worth starting this guide from scratch, rather than continuing from this PR.

I would suggest that whoever does pick it up do at least one deprecation in CPython beforehand. I think part of the issue here was that current practices aren't written down, which made it easy to end up inventing new ones. If you have any questions while working on this, feel free to ask/ping me.

Unfortunately, that would rule me out as a candidate to carry this work forward. Maybe that's okay, but I am also happy to write down current practice with a bit of guidance. I'll circle back on the idea -- there might be other places where I can be more helpful.

Given that review time was sunk into this, rather than it being closed, I was under the impression that it was close (or close enough) to be worth carrying on and preserving commits/credit.
However, I now see the CLA Signing check is also blocked, so we can't take this work anyway. I recommend closing this.

CLA Signing check

Based on the bot's comment above, it's alright. But this has been stale for a long time, so I think it's time to close anyway.

Oh, I hadn't noticed the comment, only the GHA check status. Odd that they got out of alignment, but okay anyway. 😄

It sometimes get stuck like that, if I re-opened it would re-run and go green.