Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

gh-136672: Docs: Move Enum functions and add examples#136791

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.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Open
RafaelWO wants to merge2 commits intopython:main
base:main
Choose a base branch
Loading
fromRafaelWO:change/docs-move-enum-functions-and-add-examples

Conversation

RafaelWO
Copy link
Contributor

@RafaelWORafaelWO commentedJul 19, 2025
edited by github-actionsbot
Loading

When theEnum functions_add_alias_ and_add_value_alias_ were added inde6bca9, the documentation for them was done underEnumType instead ofEnum.

This change moves them to the docs of theEnum class and adds an example for each function.

Additionally, it moves theversionadded forEnumType to the top and fixes the indentation of anotherversionchanged entry.


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

@RafaelWO
Copy link
ContributorAuthor

Thanks for reviewing,@AA-Turner 🙃

When the `Enum` functions `_add_alias_` and `_add_value_alias_` were added inde6bca9, the documentation for them was done under `EnumType` instead of `Enum`.This change moves them to the docs of the `Enum` class and adds an example for each function.
This change moves the `versionadded` for `EnumType` to the top.Additionally, it fixes the indentation of another `versionchanged` entry.
@RafaelWORafaelWOforce-pushed thechange/docs-move-enum-functions-and-add-examples branch from69e75be to4b25a5fCompareJuly 19, 2025 11:31
Copy link
Member

@ethanfurmanethanfurman left a comment

Choose a reason for hiding this comment

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

Mostly good, just one small change.

Comment on lines +881 to 884
-:meth:`~Enum._add_alias_` -- adds a new name as an alias to an existing
member.
-:meth:`~EnumType._add_value_alias_` -- adds a new value as an alias to an
-:meth:`~Enum._add_value_alias_` -- adds a new value as an alias to an
existing member.
Copy link
Member

Choose a reason for hiding this comment

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

Please move these lines to the bottom of the list.

@bedevere-app
Copy link

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phraseI have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

@AA-TurnerAA-Turner added needs backport to 3.13bugs and security fixes needs backport to 3.14bugs and security fixes labelsJul 19, 2025
Copy link
Member

@AA-TurnerAA-Turner left a comment

Choose a reason for hiding this comment

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

Thank you@RafaelWO! Please could you have a look at Ethan's suggestions.

A

Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment
Reviewers

@ethanfurmanethanfurmanethanfurman requested changes

@AA-TurnerAA-TurnerAA-Turner approved these changes

Assignees
No one assigned
Labels
awaiting mergedocsDocumentation in the Doc dirneeds backport to 3.13bugs and security fixesneeds backport to 3.14bugs and security fixesskip newssprint
Projects
Status: Todo
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

3 participants
@RafaelWO@ethanfurman@AA-Turner

[8]ページ先頭

©2009-2025 Movatter.jp