The internals documentation is scattered in markdown files in the codebase, as well as parts which are in the dev guide. We would like to have it in one place, versioned along with the code (unlike the dev guide).

Linked PRs

• gh-119786: create folder in cpython repo for internals documentation #119787
• gh-119786: move exception handling doc to InternalDocs #119815
• gh-119786: move adaptive interpreter doc from Python to InternalsDoc #120137
• gh-119786: copy compiler doc from devguide to InternalDocs and convert to markdown #120134
• gh-119786: move locations doc to InternalDocs #120445
• gh-119786: move frames documentation to InternalDocs and add details #121009
• gh-119786: improve internal docs on co_linetable #123198
• gh-119786: Edit InternalDocs/frames.md, Python/vm-state.md, Python/tier2_engine.md #124450
• gh-119786: move a few more details on exception handling from devguide to InternalDocs #124989
• gh-119786: Move parser doc from devguide to InternalDocs #125119
• gh-119786: Move garbage collection doc from devguide to InternalDocs #125282
• gh-119786: move interpreter doc from devguide to InternalDocs #125715
• gh-119786: move 'changing grammar' checklist from devguide to InternalDocs #125874
• gh-119786:: move 'repo structure' and 'additional resources' from devguide to InternalDocs #125888
• gh-119786: add code object doc, inline locations.md into it #126832
• gh-119786: Add jit.md. Move adaptive.md to a section of interpreter.md. #127175
• gh-119786: Mention InternalDocs/interpreter.md instead of non-existing adaptive.md #128329
• gh-119786: added InternalDocs/generators.md #128524
• gh-119786: Fix typo in InternalDocs/string_interning.md #131203
• gh-119786: add JUMP_BACKWARD macro to the Jumps section #131213
• gh-119786: Fix _PyExecutorObject link at jit.md file #131382

Cosmetic PRs

• gh-119786: add links to code in exception handling doc #120077
• gh-119786: fix broken links in docs and comment #121601
• gh-119786: Replace a Sphinx role with literal syntax #124990
• gh-119786: [doc] broken link and typo fix in interpreter_definition.md  #125455
• gh-119786: fix typo in compiler.md #125456
• gh-119786: [doc] more consistent syntax in InternalDocs #125815
• gh-119786: cleanup internal docs and fix internal links #127485
• gh-119786: fix miscellaneous typos in interpreter_definition.md #127957
• gh-119786: fix typos in InternalDocs/interpreter.md #128174
• gh-119786: Fix typos in InternalDocs/frames.md #128275
• gh-119786: Fix typos in InternalDocs/parser.md #128314