Skip to content

Conversation

corteisjr
Copy link

@corteisjr corteisjr commented Sep 9, 2025

This PR adds the :sorted: option to Doc/glossary.rst.

Benefits:

  • Ensures glossary entries are always alphabetically ordered.
  • Uses locale-specific ordering, improving translations.
  • Prevents manual ordering mistakes.

Collateral effects:

  • "..." now appears before ">>>"
  • Dunder entries (__future__, __slots__) appear before "a"

Discussion: https://discuss.python.org/t/glossary-alphabetically-ordering-for-all-language/101778/1

Fixes gh-138700

Issue

#138700 (comment)


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

@python-cla-bot
Copy link

python-cla-bot bot commented Sep 9, 2025

All commit authors signed the Contributor License Agreement.

CLA signed

@AA-Turner
Copy link
Member

Premature per issue.

A

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
awaiting review docs Documentation in the Doc dir skip news
Projects
Status: Todo
Development

Successfully merging this pull request may close these issues.

Doc: Glossary alphabetic order is only for English
2 participants