Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

create an internals documentation folder in the cpython repo #119786

Open
iritkatriel opened this issue May 30, 2024 · 4 comments
Open

create an internals documentation folder in the cpython repo #119786

iritkatriel opened this issue May 30, 2024 · 4 comments
Assignees
@iritkatriel
Labels
docs Documentation in the Doc dir

Comments

@iritkatriel
Copy link
Member

iritkatriel commented May 30, 2024 •
edited by bedevere-app bot
Loading

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

Cosmetic PRs
@iritkatriel iritkatriel added the docs Documentation in the Doc dir label May 30, 2024
@iritkatriel iritkatriel self-assigned this May 30, 2024
iritkatriel added a commit to iritkatriel/cpython that referenced this issue May 30, 2024
@iritkatriel
pythongh-119786: create folder in cpython repo for internals document…
d97f218 
…ation
@bedevere-app bedevere-app bot mentioned this issue May 30, 2024
Merged
iritkatriel added a commit to iritkatriel/cpython that referenced this issue May 30, 2024
@iritkatriel
pythongh-119786: create folder in cpython repo for internals document…
10ef7b6 
…ation
iritkatriel added a commit to iritkatriel/cpython that referenced this issue May 30, 2024
@iritkatriel
pythongh-119786: create folder in cpython repo for internals document…
f86a082 
…ation
iritkatriel added a commit that referenced this issue May 30, 2024
@iritkatriel
gh-119786: create folder in cpython repo for internals documentation (#…
e91fc11 
…119787)
@bedevere-app bedevere-app bot mentioned this issue May 30, 2024
Merged
iritkatriel added a commit that referenced this issue Jun 3, 2024
@iritkatriel
gh-119786: move exception handling doc to InternalDocs (#119815)
367adc9
mliezun pushed a commit to mliezun/cpython that referenced this issue Jun 3, 2024
@iritkatriel @mliezun
pythongh-119786: move exception handling doc to InternalDocs (python#…
f9871ff 
…119815)
iritkatriel added a commit to iritkatriel/cpython that referenced this issue Jun 4, 2024
@iritkatriel
pythongh-119786: move interpreter doc from the devguide to InternalDocs
646632a
@bedevere-app bedevere-app bot mentioned this issue Jun 4, 2024
Closed
3 tasks
iritkatriel added a commit to iritkatriel/cpython that referenced this issue Jun 4, 2024
@iritkatriel
pythongh-119786: add links to code
b40e822
iritkatriel added a commit to iritkatriel/cpython that referenced this issue Jun 4, 2024
@iritkatriel
pythongh-119786: add links to code
0df6d67
@bedevere-app bedevere-app bot mentioned this issue Jun 4, 2024
Merged
iritkatriel added a commit that referenced this issue Jun 5, 2024
@iritkatriel
gh-119786: add links to code in exception handling doc (#120077)
10eac02
barneygale pushed a commit to barneygale/cpython that referenced this issue Jun 5, 2024
@iritkatriel @barneygale
pythongh-119786: move exception handling doc to InternalDocs (python#…
400bfbd 
…119815)
barneygale pushed a commit to barneygale/cpython that referenced this issue Jun 5, 2024
@iritkatriel @barneygale
pythongh-119786: add links to code in exception handling doc (python#…
37f92ed 
…120077)
iritkatriel added a commit to iritkatriel/cpython that referenced this issue Jun 5, 2024
@iritkatriel
pythongh-119786: move adaptive interpreter doc from Python to Interna…
58fa42e 
…lsDoc
This was referenced Jun 5, 2024
Merged
Merged
iritkatriel added a commit that referenced this issue Jun 6, 2024
@iritkatriel
gh-119786: move adaptive interpreter doc from Python to InternalsDoc (#…
eeb8f67 
…120137)
iritkatriel added a commit that referenced this issue Jun 10, 2024
@iritkatriel @AA-Turner
@brettcannon @willingc @banool @sweeneyde @merwok @ezio-melotti @birkenfeld @gvanrossum @hugovk @jeff5 @DimitrisJim @Fidget-Spinner @Lincoln-developer @Mariatta @MahadMuhammad @ned-deily @pablogsal @serhiy-storchaka @matrixise @suriyaa @zware @psyker156 @slateny @soolabettu @zikcheng
gh-119786: copy compiler doc from devguide to InternalDocs and conver…
56c3815 
…t to markdown (#120134)

* gh-119876: move compiler doc from devguide to InternalDocs

Copy of python/devguide@78fc0d7

Co-Authored-By: Adam Turner <[email protected]>
Co-Authored-By: Adam Turner <[email protected]>
Co-Authored-By: Brett Cannon <[email protected]>
Co-Authored-By: Carol Willing <[email protected]>
Co-Authored-By: Daniel Porteous <[email protected]>
Co-Authored-By: Dennis Sweeney <[email protected]>
Co-Authored-By: Éric Araujo <[email protected]>
Co-Authored-By: Erlend Egeberg Aasland <[email protected]>
Co-Authored-By: Ezio Melotti <[email protected]>
Co-Authored-By: Georg Brandl <[email protected]>
Co-Authored-By: Guido van Rossum <[email protected]>
Co-Authored-By: Hugo van Kemenade <[email protected]>
Co-Authored-By: Irit Katriel <[email protected]>
Co-Authored-By: Jeff Allen <[email protected]>
Co-Authored-By: Jim Fasarakis-Hilliard <[email protected]>
Co-Authored-By: Ken Jin <[email protected]>
Co-Authored-By: Lincoln <[email protected]>
Co-Authored-By: Mariatta <[email protected]>
Co-Authored-By: Muhammad Mahad <[email protected]>
Co-Authored-By: Ned Deily <[email protected]>
Co-Authored-By: Pablo Galindo Salgado <[email protected]>
Co-Authored-By: Serhiy Storchaka <[email protected]>
Co-Authored-By: Stéphane Wirtel <[email protected]>
Co-Authored-By: Suriyaa ✌️️ <[email protected]>
Co-Authored-By: Zachary Ware <[email protected]>
Co-Authored-By: psyker156 <[email protected]>
Co-Authored-By: slateny <[email protected]>
Co-Authored-By: svelankar <[email protected]>
Co-Authored-By: zikcheng <[email protected]>

* convert to markdown

* add to index

* update more of the out of date stuff

---------

Co-authored-by: Adam Turner <[email protected]>
Co-authored-by: Brett Cannon <[email protected]>
Co-authored-by: Carol Willing <[email protected]>
Co-authored-by: Daniel Porteous <[email protected]>
Co-authored-by: Dennis Sweeney <[email protected]>
Co-authored-by: Éric Araujo <[email protected]>
Co-authored-by: Erlend Egeberg Aasland <[email protected]>
Co-authored-by: Ezio Melotti <[email protected]>
Co-authored-by: Georg Brandl <[email protected]>
Co-authored-by: Guido van Rossum <[email protected]>
Co-authored-by: Hugo van Kemenade <[email protected]>
Co-authored-by: Jeff Allen <[email protected]>
Co-authored-by: Jim Fasarakis-Hilliard <[email protected]>
Co-authored-by: Ken Jin <[email protected]>
Co-authored-by: Lincoln <[email protected]>
Co-authored-by: Mariatta <[email protected]>
Co-authored-by: Muhammad Mahad <[email protected]>
Co-authored-by: Ned Deily <[email protected]>
Co-authored-by: Pablo Galindo Salgado <[email protected]>
Co-authored-by: Serhiy Storchaka <[email protected]>
Co-authored-by: Stéphane Wirtel <[email protected]>
Co-authored-by: Suriyaa ✌️️ <[email protected]>
Co-authored-by: Zachary Ware <[email protected]>
Co-authored-by: psyker156 <[email protected]>
Co-authored-by: slateny <[email protected]>
Co-authored-by: svelankar <[email protected]>
Co-authored-by: zikcheng <[email protected]>
iritkatriel added a commit to iritkatriel/cpython that referenced this issue Jun 13, 2024
@iritkatriel
pythongh-119786: move locations doc to InternalDocs. Delete lnotab_no…
83b9001 
…tes.txt as it is for older versions
iritkatriel added a commit to iritkatriel/cpython that referenced this issue Jun 13, 2024
@iritkatriel
pythongh-119786: move locations doc to InternalDocs. Delete lnotab_no…
5c8f375 
…tes.txt as it is for older versions
@bedevere-app bedevere-app bot mentioned this issue Jun 13, 2024
Merged
iritkatriel added a commit that referenced this issue Jun 19, 2024
@iritkatriel
gh-119786: move locations doc to InternalDocs (#120445)
d484383
iritkatriel added a commit to iritkatriel/cpython that referenced this issue Jun 25, 2024
@iritkatriel
pythongh-119786: move frames documentation to InternalDocs and add de…
ba933ea 
…tails
@bedevere-app bedevere-app bot mentioned this issue Jun 25, 2024
Merged
iritkatriel added a commit that referenced this issue Jun 26, 2024
@iritkatriel
gh-119786: move frames documentation to InternalDocs and add details (#…
c878767 
…121009)
iritkatriel added a commit that referenced this issue Dec 6, 2024
@iritkatriel
gh-119786: Add jit.md. Move adaptive.md to a section of interpreter.m…
89fa7ec 
…d. (#127175)
kumaraditya303 pushed a commit that referenced this issue Dec 7, 2024
@srinivasreddy
gh-119786: fix typo in InternalDocs/garbage_collector.md (#127687)
72dca6c
@bedevere-app bedevere-app bot mentioned this issue Dec 15, 2024
Merged
Eclips4 pushed a commit that referenced this issue Dec 15, 2024
@StanFromIreland
gh-119786: Fix miscellaneous typos in `InternalDocs/interpreter_defin…
7b8bd3b 
…ition.md` (#127957)
@bedevere-app bedevere-app bot mentioned this issue Dec 22, 2024
Merged
Eclips4 pushed a commit that referenced this issue Dec 22, 2024
@WolframAlph
gh-119786: Fix typos in InternalDocs/interpreter.md (#128174)
f420bdd
srinivasreddy pushed a commit to srinivasreddy/cpython that referenced this issue Dec 23, 2024
@WolframAlph @srinivasreddy
pythongh-119786: Fix typos in InternalDocs/interpreter.md (python#1…
6331c05 
…28174)
@bedevere-app bedevere-app bot mentioned this issue Dec 26, 2024
Merged
kumaraditya303 pushed a commit that referenced this issue Dec 26, 2024
@WolframAlph
gh-119786: Fix typos in InternalDocs/frames.md (#128275)
c6563f3 
Fix typos in `InternalDocs/frames.md`
@bedevere-app bedevere-app bot mentioned this issue Dec 28, 2024
Merged
Eclips4 pushed a commit that referenced this issue Dec 28, 2024
@WolframAlph
gh-119786: Fix typos in InternalDocs/parser.md (#128314)
2cf396c
@bedevere-app bedevere-app bot mentioned this issue Dec 29, 2024
Merged
Eclips4 pushed a commit that referenced this issue Dec 30, 2024
@WolframAlph @ZeroIntensity
gh-119786: Mention InternalDocs/interpreter.md instead of non-exist…
fe4dd07 
…ing `adaptive.md` (#128329)

`Python/specialize.c`: Mention `InternalDocs/interpreter.md` instead of non-existing `adaptive.md`


Co-authored-by: Peter Bierma <[email protected]>
iritkatriel added a commit to iritkatriel/cpython that referenced this issue Jan 5, 2025
@iritkatriel
pythongh-119786: added InternalDocs/generators.md
a3644e5
@bedevere-app bedevere-app bot mentioned this issue Jan 5, 2025
Open
srinivasreddy pushed a commit to srinivasreddy/cpython that referenced this issue Jan 8, 2025
@picnixz @srinivasreddy
pythongh-119786: improve internal docs on co_linetable (python#123198)
eb3b040
srinivasreddy pushed a commit to srinivasreddy/cpython that referenced this issue Jan 8, 2025
@picnixz @srinivasreddy
pythongh-119786: cleanup internal docs and fix internal links (python…
d9ee48c 
…#127485)
srinivasreddy pushed a commit to srinivasreddy/cpython that referenced this issue Jan 8, 2025
@iritkatriel @srinivasreddy
pythongh-119786: Add jit.md. Move adaptive.md to a section of interpr…
f27b290 
…eter.md. (python#127175)
srinivasreddy added a commit to srinivasreddy/cpython that referenced this issue Jan 8, 2025
@srinivasreddy
pythongh-119786: fix typo in InternalDocs/garbage_collector.md (pyt…
14d9a07 
…hon#127687)
srinivasreddy pushed a commit to srinivasreddy/cpython that referenced this issue Jan 8, 2025
@StanFromIreland @srinivasreddy
pythongh-119786: Fix miscellaneous typos in `InternalDocs/interpreter…
5e0bc40 
…_definition.md` (python#127957)
srinivasreddy pushed a commit to srinivasreddy/cpython that referenced this issue Jan 8, 2025
@WolframAlph @srinivasreddy
pythongh-119786: Fix typos in InternalDocs/interpreter.md (python#1…
f42b555 
…28174)
srinivasreddy pushed a commit to srinivasreddy/cpython that referenced this issue Jan 8, 2025
@WolframAlph @srinivasreddy
pythongh-119786: Fix typos in InternalDocs/frames.md (python#128275)
55a6102 
Fix typos in `InternalDocs/frames.md`
srinivasreddy pushed a commit to srinivasreddy/cpython that referenced this issue Jan 8, 2025
@WolframAlph @srinivasreddy
pythongh-119786: Fix typos in InternalDocs/parser.md (python#128314)
fef2607
srinivasreddy pushed a commit to srinivasreddy/cpython that referenced this issue Jan 8, 2025
@WolframAlph @ZeroIntensity @srinivasreddy
pythongh-119786: Mention InternalDocs/interpreter.md instead of non…
378d062 
…-existing `adaptive.md` (python#128329)

`Python/specialize.c`: Mention `InternalDocs/interpreter.md` instead of non-existing `adaptive.md`


Co-authored-by: Peter Bierma <[email protected]>
ebonnal pushed a commit to ebonnal/cpython that referenced this issue Jan 12, 2025
@iritkatriel @ebonnal
pythongh-119786: move interpreter doc from devguide to InternalDocs (p…
4c0c1f7 
…ython#125715)
ebonnal pushed a commit to ebonnal/cpython that referenced this issue Jan 12, 2025
@iritkatriel @ebonnal
pythongh-119786: [doc] more consistent syntax in InternalDocs (python…
eab24b8 
…#125815)
ebonnal pushed a commit to ebonnal/cpython that referenced this issue Jan 12, 2025
@iritkatriel @ebonnal
pythongh-119786: move 'changing grammar' checklist from devguide to I…
c2fd29f 
…nternalDocs (python#125874)
ebonnal pushed a commit to ebonnal/cpython that referenced this issue Jan 12, 2025
@iritkatriel @ebonnal
pythongh-119786: add code object doc, inline locations.md into it (py…
4ff09eb 
…thon#126832)
ebonnal pushed a commit to ebonnal/cpython that referenced this issue Jan 12, 2025
@picnixz @ebonnal
pythongh-119786: improve internal docs on co_linetable (python#123198)
f9e4710
ebonnal pushed a commit to ebonnal/cpython that referenced this issue Jan 12, 2025
@picnixz @ebonnal
pythongh-119786: cleanup internal docs and fix internal links (python…
cf8394d 
…#127485)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@iritkatriel iritkatriel

Labels
docs Documentation in the Doc dir
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
3 participants
@colesbury @iritkatriel @Eclips4