In the document build process the code in Doc/tools/extensions/pyspecific.py maps BPO or # references to bugs.python.org which as been retired and replaced with Issues in https://github.com/python/cpython/issues/ however while the issues that existed at bugs.python.org all have been ported to https://github.com/python/cpython/issues/ the reference numbers are not the same so simply changing the URL does not map to the correct issue - e.g. BPO-45292 was https://bugs.python.org/issue45292 but is now #89455 i.e. 89455 not 45292

Possible approaches include:

1. Generate a mapping for all of the BPO entries and using that for all historic commits a large file with no other use
2. Check each issue to get the link from the BPO page to the GH page time consuming and likely to hit rate limits
3. Come up with a cut off number where all references below it are still mapped to BPO and those after to GH. may work but where items were opened on BPO and are now on GH may be misleading.
4. Come up with a tag, e.g. gh or PGH as an alternative to BPO and use the new URL for those - relies on all the users remembering to use it
5. Any references that are bare # without a BPO prefix reference the GitHub issue but map those with the prefix to BPO. Risk that some older issue references also just use # and are incorrectly mapped as a result.
6. See if there is a simple formula to transform - if all of the issues were transferred contiguously and in order there may be!
7. Combine 5 with 3 - less likely to hit both issues at once!

Some guidance/discussion on the preferred approach is needed.