python / devguide

The Python developer's guide
https://devguide.python.org/
Creative Commons Zero v1.0 Universal
1.83k stars 756 forks source link

Slim down or remove remaining internals docs #1347

Open willingc opened 2 months ago

willingc commented 2 months ago

https://github.com/python/cpython/issues/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 commented 1 month ago

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[^1]? Was using rst considered?

For context, in addition to the issue linked by Carol

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

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

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

[^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.