Skip to content

gh-154559: Link the annotations future statement to the language reference#154608

Open
gchaber wants to merge 1 commit into
python:mainfrom
gchaber:gh-154559-future-annotations-link
Open

gh-154559: Link the annotations future statement to the language reference#154608
gchaber wants to merge 1 commit into
python:mainfrom
gchaber:gh-154559-future-annotations-link

Conversation

@gchaber

@gchaber gchaber commented Jul 24, 2026

Copy link
Copy Markdown

Closes #154559

The annotations entry in the future-statements table in the __future__ documentation lists PEP 563 and PEP 649, but does not link to the language reference section that documents how annotations actually behave in current Python (https://docs.python.org/3/reference/compound_stmts.html#annotations).

This adds a :ref:annotations`` cross-reference to that table row, as suggested by @picnixz in the issue discussion.

Documentation-only change, so no NEWS entry is included (the skip news label applies). Verified with a full docs build (make -C Doc html, which runs Sphinx with --fail-on-warning): build completes with zero warnings and the rendered page links to reference/compound_stmts.html#annotations.

make patchcheck is clean.

@python-cla-bot

python-cla-bot Bot commented Jul 24, 2026

Copy link
Copy Markdown

All commit authors signed the Contributor License Agreement.

CLA signed

@read-the-docs-community

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33743995 | 📁 Comparing 41f261a against main (a400767)

  🔍 Preview build  

1 file changed
± library/__future__.html

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.

Docs: problem with page "__future__ — Future statement definitions"

1 participant