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

remove the assumptions from The tutorial #107017

Open
JakubDotPy opened this issue Jul 22, 2023 · 2 comments
Open

remove the assumptions from The tutorial #107017

JakubDotPy opened this issue Jul 22, 2023 · 2 comments
Labels
docs Documentation in the Doc dir

Comments

@JakubDotPy
Copy link
Contributor

JakubDotPy commented Jul 22, 2023 •
edited by bedevere-bot
Loading

Documentation

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
@JakubDotPy JakubDotPy added the docs Documentation in the Doc dir label Jul 22, 2023
This was referenced Jul 22, 2023
Merged
Merged
@serhiy-storchaka
Copy link
Member

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.

@JakubDotPy
Copy link
Contributor Author

JakubDotPy commented Jul 22, 2023 •
edited
Loading

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.

hugovk pushed a commit that referenced this issue Jul 23, 2023
@JakubDotPy
gh-107017: removed mention that C does it the same way (#107020)
9629d44
@bedevere-bot bedevere-bot mentioned this issue Jul 23, 2023
Merged
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Jul 23, 2023
@JakubDotPy @miss-islington
pythongh-107017: removed mention that C does it the same way (pythonG…
6832b14 
…H-107020)

(cherry picked from commit 9629d44)

Co-authored-by: Jakub Červinka <[email protected]>
@bedevere-bot bedevere-bot mentioned this issue Jul 23, 2023
Merged
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Jul 23, 2023
@JakubDotPy @miss-islington
pythongh-107017: removed mention that C does it the same way (pythonG…
fe7db23 
…H-107020)

(cherry picked from commit 9629d44)

Co-authored-by: Jakub Červinka <[email protected]>
hugovk pushed a commit that referenced this issue Jul 23, 2023
@miss-islington @JakubDotPy
[3.12] gh-107017: removed mention that C does it the same way (GH-107020
98626c3 
) (#107097)

Co-authored-by: Jakub Červinka <[email protected]>
hugovk pushed a commit that referenced this issue Jul 23, 2023
@miss-islington @JakubDotPy
[3.11] gh-107017: removed mention that C does it the same way (GH-107020
7d41487 
) (#107098)

Co-authored-by: Jakub Červinka <[email protected]>
@bedevere-bot bedevere-bot mentioned this issue Jul 23, 2023
Merged
hugovk pushed a commit that referenced this issue Jul 23, 2023
@TommyUnreal @hauntsaninja
gh-107017: Analolgy to Pascal and C replaced. (#107025)
e59da0c 
Co-authored-by: Shantanu <[email protected]>
@bedevere-bot bedevere-bot mentioned this issue Jul 23, 2023
Merged
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Jul 23, 2023
@TommyUnreal @hauntsaninja @miss-islington
pythongh-107017: Analolgy to Pascal and C replaced. (pythonGH-107025)
2bfa026 
(cherry picked from commit e59da0c)

Co-authored-by: TommyUnreal <[email protected]>
Co-authored-by: Shantanu <[email protected]>
@bedevere-bot bedevere-bot mentioned this issue Jul 23, 2023
Merged
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Jul 23, 2023
@TommyUnreal @hauntsaninja @miss-islington
pythongh-107017: Analolgy to Pascal and C replaced. (pythonGH-107025)
7baeaa3 
(cherry picked from commit e59da0c)

Co-authored-by: TommyUnreal <[email protected]>
Co-authored-by: Shantanu <[email protected]>
hugovk added a commit that referenced this issue Jul 23, 2023
@miss-islington @TommyUnreal
@hauntsaninja @hugovk
[3.11] gh-107017: Analolgy to Pascal and C replaced. (GH-107025) (#10…
6138ecd 
…7123)

Co-authored-by: TommyUnreal <[email protected]>
Co-authored-by: Shantanu <[email protected]>
Co-authored-by: Hugo van Kemenade <[email protected]>
ambv pushed a commit that referenced this issue Jul 23, 2023
@miss-islington @TommyUnreal @hauntsaninja
[3.12] gh-107017: Analolgy to Pascal and C replaced. (GH-107025) (#10…
e02ddb3 
…7124)

(cherry picked from commit e59da0c)

Co-authored-by: TommyUnreal <[email protected]>
Co-authored-by: Shantanu <[email protected]>
@bedevere-bot bedevere-bot mentioned this issue Jul 23, 2023
Open
jtcave pushed a commit to jtcave/cpython that referenced this issue Jul 23, 2023
@JakubDotPy @jtcave
pythongh-107017: removed mention that C does it the same way (python#…
593c34b 
…107020)
jtcave pushed a commit to jtcave/cpython that referenced this issue Jul 23, 2023
@TommyUnreal @hauntsaninja @jtcave
pythongh-107017: Analolgy to Pascal and C replaced. (python#107025)
610db99 
Co-authored-by: Shantanu <[email protected]>
mementum pushed a commit to mementum/cpython that referenced this issue Jul 23, 2023
@JakubDotPy @mementum
pythongh-107017: removed mention that C does it the same way (python#…
310639c 
…107020)
mementum pushed a commit to mementum/cpython that referenced this issue Jul 23, 2023
@TommyUnreal @hauntsaninja @mementum
pythongh-107017: Analolgy to Pascal and C replaced. (python#107025)
2d648af 
Co-authored-by: Shantanu <[email protected]>
hugovk added a commit that referenced this issue Jul 24, 2023
@TommyUnreal @hugovk
gh-107017: Change Chapter Strings to Texts in the Introduction chapte…
2cf9902 
…r. (#107104)

Co-authored-by: Hugo van Kemenade <[email protected]>
@bedevere-bot bedevere-bot mentioned this issue Jul 24, 2023
Merged
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Jul 24, 2023
@TommyUnreal @hugovk @miss-islington
pythongh-107017: Change Chapter Strings to Texts in the Introduction …
220780b 
…chapter. (pythonGH-107104)

(cherry picked from commit 2cf9902)

Co-authored-by: TommyUnreal <[email protected]>
Co-authored-by: Hugo van Kemenade <[email protected]>
@bedevere-bot bedevere-bot mentioned this issue Jul 24, 2023
Merged
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Jul 24, 2023
@TommyUnreal @hugovk @miss-islington
pythongh-107017: Change Chapter Strings to Texts in the Introduction …
59a5d76 
…chapter. (pythonGH-107104)

(cherry picked from commit 2cf9902)

Co-authored-by: TommyUnreal <[email protected]>
Co-authored-by: Hugo van Kemenade <[email protected]>
hugovk added a commit that referenced this issue Jul 24, 2023
@miss-islington @TommyUnreal @hugovk
[3.12] gh-107017: Change Chapter Strings to Texts in the Introduction…
beb5514 
… chapter. (GH-107104) (#107167)

Co-authored-by: TommyUnreal <[email protected]>
Co-authored-by: Hugo van Kemenade <[email protected]>
hugovk added a commit that referenced this issue Jul 24, 2023
@miss-islington @TommyUnreal @hugovk
[3.11] gh-107017: Change Chapter Strings to Texts in the Introduction…
8725d36 
… chapter. (GH-107104) (#107168)

Co-authored-by: TommyUnreal <[email protected]>
Co-authored-by: Hugo van Kemenade <[email protected]>
carljm added a commit to carljm/cpython that referenced this issue Jul 24, 2023
@carljm
Merge branch 'main' into superfix
9a6bdfa 
* main: (73 commits)
  Thoroughly refactor the cases generator (python#107151)
  Docs: Add missing markup to Argument Clinic docs (python#106876)
  pythongh-107162: Document errcode.h usage in its comment (python#107177)
  pythongh-106320: Remove private _PyDict C API (python#107145)
  Fix PyVectorcall_Function doc versionadded (python#107140)
  Docs: Remove duplicate word in Argument Clinic howto heading (python#107169)
  pythongh-107017: Change Chapter Strings to Texts in the Introduction chapter. (python#107104)
  pythongh-106320: Remove private _PyObject C API (python#107159)
  Docs: fix typo in os.pwrite docstring (python#107087)
  pythongh-105291: Add link to migration guide for distutils (python#107130)
  pythongh-106948: Docs: Disable links for C standard library functions, OS utility functions and system calls (python#107062)
  pythongh-106320: Remove _PyBytes_Join() C API (python#107144)
  pythongh-106320: Remove private _PyObject C API (python#107147)
  pythongh-106320: Remove _PyTuple_MaybeUntrack() C API (python#107143)
  pythongh-106320: Remove _PyIsSelectable_fd() C API (python#107142)
  Remove superflous whitespaces in `layout.html`. (pythonGH-107067)
  pythongh-107122: Update what's news for dbm.*dbm.clear() method (pythongh-107135)
  pythongh-107122: Add clear method to dbm.ndbm module (pythongh-107126)
  pythongh-62519: Make pgettext search plurals when translation is not found (python#107118)
  pythongh-107122: Add clear method to dbm.gdbm.module (pythongh-107127)
  ...
@zware zware mentioned this issue Jun 3, 2024
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
docs Documentation in the Doc dir
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@serhiy-storchaka @JakubDotPy