-
-
Notifications
You must be signed in to change notification settings - Fork 33.2k
gh-58032: Docs: Sort argparse alphabetically #125871
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 our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I intentionally moved builtins at the beginning of the list.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks Hugo!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
🚢
@serhiy-storchaka What prompted you to move to the beginning? Perhaps we need a sentence or section break between them @hugovk |
|
Builtins look special to me, and in some other places we list them separately from other modules. I thought that even if we list them in the common list with other modules, it is worth to move the builtins module to the beginning. But I may be wrong here -- in few last What's New files (3.13, 3.14) they are listed alphabetically in the list of modules. |
|
Thanks for clarifying @serhiy-storchaka. @hugovk, do you want to offset built-ins from the rest of standard library modules? |
|
In a way it's just another module in the docs, and I'd prefer alphabetical, but I don't mind too much. If we're browsing a long list, it's easier to find alphabetically, and it'll be less likely for new edits to be added in arbitrary order if it begins with A instead of B. cc @AA-Turner who edited the last two versions, any opinion? |
|
I'm going to go ahead and merge this to unblock the PR. We can always create future iterations to improve the difference between builtins and the other libraries. |
Sort argparse alphabetically
Sort argparse alphabetically
Follow on from #124664, let's keep the modules sorted alphabetically.
📚 Documentation preview 📚: https://cpython-previews--125871.org.readthedocs.build/