Skip to content

gh-154388: Document Python install variants - #154482

Merged
zooba merged 3 commits into
python:mainfrom
BHUVANSH855:docs-154388-python-install-variants
Oct 22, 2026
Merged

gh-154388: Document Python install variants#154482
zooba merged 3 commits into
python:mainfrom
BHUVANSH855:docs-154388-python-install-variants

Conversation

@BHUVANSH855

@BHUVANSH855 BHUVANSH855 commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR documents the CPython runtime variants available through py install.

It adds a short description of the published PythonCore, PythonTest, and PythonEmbed variants to the Installing runtimes section of the Windows documentation, clarifying that these are CPython-published runtime variants rather than features of the Python install manager.

Issue

Closes gh-154388.

Testing

  • Built the documentation successfully with:

    make -C Doc html

  • Verified that the documentation builds successfully with --fail-on-warning and that the new content renders correctly in the generated HTML.

@bedevere-app bedevere-app Bot added docs Documentation in the Doc dir skip news labels Jul 22, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Jul 22, 2026
@bedevere-app bedevere-app Bot mentioned this pull request Jul 22, 2026
Closed
@read-the-docs-community

read-the-docs-community Bot commented Jul 22, 2026 •
edited
Loading

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33713657 | 📁 Comparing fe91943 against main (79cdcee)

  🔍 Preview build  

2 files changed
± library/warnings.html
± using/windows.html

@zooba

zooba commented Jul 22, 2026

Copy link
Copy Markdown
Member

That's a bit too literal a translation of the issue report. If you could, can you expand it to read more like instructive documentation for a new user - explain a bit more about each package, the circumstances when they may prefer one over the other, make a definitive recommendation (of the default), and show at least one example of the install and list --online commands for them?

@BHUVANSH855
BHUVANSH855 force-pushed the docs-154388-python-install-variants branch from f1cfef9 to fe91943 Compare July 22, 2026 19:22
@zooba

zooba commented Jul 22, 2026

Copy link
Copy Markdown
Member

Please don't force push. We always squash merge and rewrite commit messages at the end, so the history won't be in the repository.

All that force pushing achieves is to break incremental reviews - we now have to re-read your entire contribution and guess what has changed, rather than being able to see the difference from recent commits. This will slow down our review.

@BHUVANSH855

BHUVANSH855 commented Oct 22, 2026

Copy link
Copy Markdown
Contributor Author

@zooba gentle ping !

zooba
zooba reviewed Oct 22, 2026
View reviewed changes

@zooba zooba left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the ping. Couple of minor additions, it's good to merge if these are added without changes.

Comment thread Doc/using/windows.rst
Comment thread Doc/using/windows.rst Outdated
BHUVANSH855 and others added 2 commits October 23, 2026 03:34
@BHUVANSH855 @zooba
Update Doc/using/windows.rst
b3a077a 
Co-authored-by: Steve Dower <steve.dower@microsoft.com>
@BHUVANSH855 @zooba
Update Doc/using/windows.rst
963b0de 
Co-authored-by: Steve Dower <steve.dower@microsoft.com>
@BHUVANSH855
BHUVANSH855 requested a review from zooba October 22, 2026 22:05
@zooba
zooba enabled auto-merge (squash) October 22, 2026 22:10
@zooba zooba added needs backport to 3.14 bugs and security fixes needs backport to 3.15 bugs and security fixes labels Oct 22, 2026
@zooba
zooba merged commit 1f1ae14 into python:main Oct 22, 2026
34 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Oct 22, 2026
@miss-islington-app

miss-islington-app Bot commented Oct 22, 2026

Copy link
Copy Markdown

Thanks @BHUVANSH855 for the PR, and @zooba for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14, 3.15.
🐍🍒⛏🤖

@bedevere-app

bedevere-app Bot commented Oct 22, 2026

Copy link
Copy Markdown

GH-160390 is a backport of this pull request to the 3.15 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.15 bugs and security fixes label Oct 22, 2026
@bedevere-app

bedevere-app Bot commented Oct 22, 2026

Copy link
Copy Markdown

GH-160391 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label Oct 22, 2026
@BHUVANSH855
BHUVANSH855 deleted the docs-154388-python-install-variants branch October 22, 2026 23:12
zooba pushed a commit that referenced this pull request Oct 23, 2026
@miss-islington @BHUVANSH855
[3.14] gh-154388: Document Python install variants on Windows (GH-154482
9695071 
) (GH-160391)

gh-154388: Document Python install variants on Windows (GH-154482)
(cherry picked from commit 1f1ae14)

Co-authored-by: Bhuvansh <bhuvanshkataria@gmail.com>
zooba pushed a commit that referenced this pull request Oct 23, 2026
@miss-islington @BHUVANSH855
[3.15] gh-154388: Document Python install variants on Windows (GH-154482
c8f7cd2 
) (GH-160390)

gh-154388: Document Python install variants on Windows (GH-154482)
(cherry picked from commit 1f1ae14)

Co-authored-by: Bhuvansh <bhuvanshkataria@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@zooba zooba Awaiting requested review from zooba

Assignees

No one assigned

Labels

docs Documentation in the Doc dir skip news

Projects

Docs PRs
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Document PythonTest and PythonEmbed install options

2 participants

@BHUVANSH855 @zooba