Skip to content

Fix decorator cross-reference titles in docs - #159270

Closed
Marwan-verse wants to merge 2 commits into
python:mainfrom
Marwan-verse:docs/fix-deco-role-tilde-159265
Closed

Marwan-verse wants to merge 2 commits into
python:mainfrom
Marwan-verse:docs/fix-deco-role-tilde-159265

Conversation

@Marwan-verse

Copy link
Copy Markdown

Fix the Sphinx 8 decorator-role title bug reported in #159265. The role adds @ before processing ~, so affected references render as @~module.name.

Replace the 29 affected short-form references across 17 documentation files with explicit display titles. This preserves the intended short decorator names and fixes the rendering without changing the pinned Sphinx version.

Closes #159265.

AI disclosure: Prepared with OpenAI Codex.

Validation: The documentation build was not run locally; CI will check the docs.

@python-cla-bot

Copy link
Copy Markdown

The following commit authors need to sign the Contributor License Agreement:

CLA not signed

@read-the-docs-community

Copy link
Copy Markdown

@StanFromIreland

Copy link
Copy Markdown
Member

Sorry but this was premature, please wait till an action is decided on the issue.

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: :deco: references with ~ render as @~module.name

2 participants