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