Skip to content

Add note to tutorial clarifying scope #134534

New issue

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

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

Already on GitHub? # to your account

Merged
merged 3 commits into from
May 22, 2025
Merged

Add note to tutorial clarifying scope #134534

merged 3 commits into from
May 22, 2025

Conversation

kattni
Copy link
Contributor

@kattni kattni commented May 22, 2025

The official Python tutorial is designed for programmers who are new to Python, not beginners that are new to programming. I am including a note at the top of the first page to this effect, and mentioning it in the body of text to cover those who have a tendency to skip over highlighted notes. The purpose of this is to help beginners understand that experiencing difficulties with the official tutorial is to be expected, as it expects the reader to have some level of programming experience.

@nedbat @willingc


📚 Documentation preview 📚: https://cpython-previews--134534.org.readthedocs.build/

@python-cla-bot
Copy link

python-cla-bot bot commented May 22, 2025

All commit authors signed the Contributor License Agreement.

CLA signed

@nedbat nedbat merged commit 742d5b5 into python:main May 22, 2025
28 checks passed
@github-project-automation github-project-automation bot moved this from Todo to Done in Docs PRs May 22, 2025
@nedbat nedbat added needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes labels May 22, 2025
@miss-islington-app
Copy link

Thanks @kattni for the PR, and @nedbat for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖

@miss-islington-app
Copy link

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

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request May 22, 2025
* Add note to tutorial

* Update formatting
(cherry picked from commit 742d5b5)

Co-authored-by: Kattni <kattni@kattni.com>
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request May 22, 2025
* Add note to tutorial

* Update formatting
(cherry picked from commit 742d5b5)

Co-authored-by: Kattni <kattni@kattni.com>
@bedevere-app
Copy link

bedevere-app bot commented May 22, 2025

GH-134536 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 May 22, 2025
nedbat pushed a commit that referenced this pull request May 22, 2025
Docs: Add note to tutorial clarifying scope (GH-134534)

* Add note to tutorial

* Update formatting
(cherry picked from commit 742d5b5)

Co-authored-by: Kattni <kattni@kattni.com>
@hugovk hugovk added needs backport to 3.13 bugs and security fixes and removed needs backport to 3.13 bugs and security fixes labels May 22, 2025
@miss-islington-app
Copy link

Thanks @kattni for the PR, and @nedbat for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request May 22, 2025
* Add note to tutorial

* Update formatting
(cherry picked from commit 742d5b5)

Co-authored-by: Kattni <kattni@kattni.com>
@miss-islington-app
Copy link

Sorry @kattni and @nedbat, I had trouble completing the backport.
Please retry by removing and re-adding the "needs backport to 3.13" label.
Please backport backport using cherry_picker on the command line.

cherry_picker 742d5b5c5d75eae44c66a43ebfa24a4f286ea8a1 3.13

@hugovk
Copy link
Member

hugovk commented May 22, 2025

The bot couldn't do the 3.13 backport so we'll need to do it.

@kattni Would you like to give it a go? I'm also happy to take care of it tomorrow, or give some pointers.

@kattni
Copy link
Contributor Author

kattni commented May 22, 2025

@hugovk Sure, I'll give it a try!

@hugovk
Copy link
Member

hugovk commented May 22, 2025

Please backport backport using cherry_picker on the command line.

Oh look, a double "backport" typo! That's in https://github.com/python/miss-islington

@bedevere-app
Copy link

bedevere-app bot commented May 22, 2025

GH-134545 is a backport of this pull request to the 3.13 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.13 bugs and security fixes label May 22, 2025
@kattni
Copy link
Contributor Author

kattni commented May 22, 2025

@hugovk Hopefully that was correct! #134545

hugovk pushed a commit that referenced this pull request May 22, 2025
lkollar pushed a commit to lkollar/cpython that referenced this pull request May 26, 2025
* Add note to tutorial

* Update formatting
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
docs Documentation in the Doc dir skip issue skip news
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

3 participants