Skip to content

Conversation

@corteisjr
Copy link

@corteisjrcorteisjr 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

Fixesgh-138700

Issue

#138700 (comment)


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

@python-cla-bot
Copy link

python-cla-botbot 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 freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting reviewdocsDocumentation in the Doc dirskip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

Doc: Glossary alphabetic order is only for English

2 participants

@corteisjr@AA-Turner