Skip to content

feat(docs): type fix - apply pep8 by using docstring instead of comment in the doc.#135181

Merged
vstinner merged 3 commits into
python:mainfrom
jlguenego:main
Jun 6, 2025
Merged

feat(docs): type fix - apply pep8 by using docstring instead of comment in the doc.#135181
vstinner merged 3 commits into
python:mainfrom
jlguenego:main

Conversation

@jlguenego

@jlguenego jlguenego commented Jun 5, 2025

Copy link
Copy Markdown
Contributor

replace comments by pep8 docstring for function definition.


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

Giving the right example incitates the tutorial readers to do the same in the future.
@python-cla-bot

python-cla-bot Bot commented Jun 5, 2025

Copy link
Copy Markdown

All commit authors signed the Contributor License Agreement.

CLA signed

@bedevere-app bedevere-app Bot added awaiting review docs Documentation in the Doc dir skip news labels Jun 5, 2025
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Jun 5, 2025
@jlguenego jlguenego changed the title feat(docs): type fix - apply pep8 by using docstring instead of comment in the doc. feat(docs): type fix - apply pep8 by using docstring instead of comment in the doc. skip issue Jun 5, 2025
@jlguenego jlguenego changed the title feat(docs): type fix - apply pep8 by using docstring instead of comment in the doc. skip issue feat(docs): type fix - apply pep8 by using docstring instead of comment in the doc. Jun 5, 2025

@StanFromIreland StanFromIreland 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.

Since this is the tutorial, I think it makes logical sense to present best practices.

Comment thread Doc/tutorial/modules.rst Outdated
Comment thread Doc/tutorial/modules.rst Outdated
jlguenego and others added 2 commits June 6, 2025 14:37
Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Victor Stinner <vstinner@python.org>
@vstinner vstinner merged commit 3431828 into python:main Jun 6, 2025
24 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Jun 6, 2025
@vstinner vstinner added needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes labels Jun 6, 2025
@miss-islington-app

Copy link
Copy Markdown

Thanks @jlguenego for the PR, and @vstinner for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖 I'm not a witch! I'm not a witch!

@miss-islington-app

Copy link
Copy Markdown

Thanks @jlguenego for the PR, and @vstinner 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 Jun 6, 2025
…nt in the doc. (pythonGH-135181)

Giving the right example incitates the tutorial readers to do the same in the future.
(cherry picked from commit 3431828)

Co-authored-by: Jean-Louis GUENEGO <jlguenego@gmail.com>
@bedevere-app

bedevere-app Bot commented Jun 6, 2025

Copy link
Copy Markdown

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

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Jun 6, 2025
…nt in the doc. (pythonGH-135181)

Giving the right example incitates the tutorial readers to do the same in the future.
(cherry picked from commit 3431828)

Co-authored-by: Jean-Louis GUENEGO <jlguenego@gmail.com>
@bedevere-app bedevere-app Bot removed the needs backport to 3.13 bugs and security fixes label Jun 6, 2025
@bedevere-app

bedevere-app Bot commented Jun 6, 2025

Copy link
Copy Markdown

GH-135212 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 Jun 6, 2025
@vstinner

vstinner commented Jun 6, 2025

Copy link
Copy Markdown
Member

Merged, thanks.

vstinner pushed a commit that referenced this pull request Jun 6, 2025
…f comment in the doc. (GH-135181) (#135212)

feat(docs): type fix - apply pep8 by using docstring instead of comment in the doc. (GH-135181)

Giving the right example incitates the tutorial readers to do the same in the future.
(cherry picked from commit 3431828)

Co-authored-by: Jean-Louis GUENEGO <jlguenego@gmail.com>
vstinner pushed a commit that referenced this pull request Jun 6, 2025
…f comment in the doc. (GH-135181) (#135211)

feat(docs): type fix - apply pep8 by using docstring instead of comment in the doc. (GH-135181)

Giving the right example incitates the tutorial readers to do the same in the future.
(cherry picked from commit 3431828)

Co-authored-by: Jean-Louis GUENEGO <jlguenego@gmail.com>
Pranjal095 pushed a commit to Pranjal095/cpython that referenced this pull request Jul 12, 2025
…nt in the doc. (python#135181)

Giving the right example incitates the tutorial readers to do the same in the future.
taegyunkim pushed a commit to taegyunkim/cpython that referenced this pull request Aug 4, 2025
…nt in the doc. (python#135181)

Giving the right example incitates the tutorial readers to do the same in the future.
Agent-Hellboy pushed a commit to Agent-Hellboy/cpython that referenced this pull request Aug 19, 2025
…nt in the doc. (python#135181)

Giving the right example incitates the tutorial readers to do the same in the future.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in 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.

4 participants