Slim down or remove remaining internals docs

[willingc]

python/cpython#119786 moved a number of internals docs to the cpython repo. This makes good sense. We should slim down the devguide's internals section, and refer to the CPython versioned internals docs.

[ezio-melotti]

I had noticed a few related PRs and tracked down the issue you linked, but I didn't find where this was discussed/decided. While I understand the need to have a versioned doc, I wonder if (and which) other solutions have been considered, and whether the InternalDocs dir is a temporary solution or a definitive one. In particular, are there plans to publish the internal docs somewhere other than GitHub itself¹? Was using rst considered?

For context, in addition to the issue linked by Carol

• create an internals documentation folder in the cpython repo cpython#119786

and the cpython PRs linked therein, there are already a couple of PRs in this repo:

• gh-119786: remove part of devguide documentation which is duplicated in InternalDocs #1334
• gh-119786: redirect compiler doc to new location #1339

The current content of the devguide's internals section and cpython's InternalDocs can be seen at:

• https://devguide.python.org/internals/
• https://github.com/python/cpython/tree/main/InternalDocs

Are there other parts of the devguide's internals section that still need to be moved/updated?
Is python/cpython#119786 still open pending the devguide changes, or are there more docs that need to be added/converted?

Footnotes

1. Hosting it on GitHub might affect discoverability, since GitHub doesn't seem allow to allow crawlers on the source tree. To confirm, I tried searching for _PyInterpreterFrame and Tadaptive and while the former didn't yield any result in the InternalDocs, the latter did. ↩