GeezerVison is showing github.com — remove the assumptions from The tutorial · Issue #107017 · python/cpython
remove the assumptions from The tutorial #107017DescriptionDocumentation
Remove the assumptions about the knowledge of other programming languages or technologies from the tutorial section.
The tutorial section should as accessible as possible, aiming especially at the beginners.
For some of them python is their first introduction to the world of technology itself.
Linked PRs
Activityserhiy-storchaka commented on Jul 22, 2023 Beginner in Python is not necessary the beginner in programming. References to other programming languages can actually help if the user knows any other programming language. "Like in other programming languages" saves their time, allows them to skip part of the text that repeats what they already know and not try to find out the differences. Reacted by Raymond Hettinger and Brian Schubert JakubDotPy commented on Jul 22, 2023 ContributorAuthor More actions This issue specifically targets "The Tutorial" section. This section of the docs is, in my opinion, visited mainly by beginners. I can back this with my experience as a PyLadies lecturer.
I understand your point and I have nothing against references to other programming languages and technologies in other parts of the Python docs. added a commit that references this issue on Jul 24, 2023gh-107017: Change Chapter Strings to Texts in the Introduction chapte… StanFromIreland commented on Sep 4, 2025 With 742d5b5 (i.e. acknowledging that there is an assumption), is there anything left to do here?
cc @kattni kattni commented on Sep 4, 2025 This is excellent! Thank you all for the work you put in here. I would have had some minor suggestions on the PRs linked above, but nothing critical. I'm really pleased with what I'm seeing here. As long as you all feel you've addressed what you want to address, I would call this good.
MetadataMetadataStatusShow more project fields
DevelopmentNo branches or pull requestsIssue actions
|