Skip to content

GH-121970: Extract issue_role into a new extension#130615

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
AA-Turner merged 5 commits into from
Feb 27, 2025
Merged

GH-121970: Extract issue_role into a new extension #130615

AA-Turner merged 5 commits into from
Feb 27, 2025

Conversation

@AA-Turner
Copy link
Member

@AA-TurnerAA-Turner commented Feb 26, 2025•
edited by github-actions bot
Loading

@AA-TurnerAA-Turner added docs Documentation in the Doc dir skip news needs backport to 3.12 only security fixes needs backport to 3.13 bugs and security fixes labels Feb 26, 2025
@AA-TurnerAA-Turner changed the title GH-121970: Extract issue_role into a new extensionGH-121970: Extract issue_role into a new extensionFeb 26, 2025
@bedevere-appbedevere-appbot mentioned this pull request Feb 26, 2025
Open
hugovk
hugovk reviewed Feb 27, 2025
View reviewed changes
Doc/tools/extensions/issue_role.py
return [prb], [msg]

issue_url = self.ISSUE_URI.format(issue)
refnode = nodes.reference(issue, f"bpo-{issue}", refuri=issue_url)
Copy link
Member

@hugovkhugovkFeb 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here we're passing something like 12345 and bpo-12345 as the first two arguments.

Before we were passing something like bpo-12345 and bpo-12345 for both.

I see the second one is used in the refnode:

<reference refuri="https://bugs.python.org/issue?@action=redirect&bpo=13936">bpo-13936</reference>

How is the first one used?

Copy link
MemberAuthor

@AA-TurnerAA-TurnerFeb 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's the docutils rawsource, it should reflect what was actually written in the document.

Sphinx uses this for translation, I don't think these nodes are translatable but I'll double check.

A

Copy link
MemberAuthor

@AA-TurnerAA-TurnerFeb 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See e.g. https://github.com/python/python-docs-fr/blob/3.13/whatsnew/3.13.po#L394-L399, the whole role is included in the translation string.

Copy link
Member

@hugovkhugovkFeb 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So should it match 12345 or bpo-12345?

Copy link
Member

@hugovkhugovkFeb 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(Unresolving so the question isn't hidden :)

Copy link
MemberAuthor

@AA-TurnerAA-TurnerFeb 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The text of what is actually written in the document, so "14159".

AA-Turnerand others added 2 commits February 27, 2025 14:21
@AA-Turner@hugovk
Hugo's review
6fa8680
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
@AA-Turner
Revert TC=False
3b46c04
hugovk
hugovk approved these changes Feb 27, 2025
View reviewed changes
Copy link
Member

@hugovkhugovk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@AA-TurnerAA-Turner merged commit 043ab3a into python:mainFeb 27, 2025
28 checks passed
@github-project-automationgithub-project-automationbot moved this from Todo to Done in Docs PRsFeb 27, 2025
@miss-islington-app
Copy link

miss-islington-appbot commented Feb 27, 2025

Thanks @AA-Turner for the PR 🌮🎉.. I'm working now to backport this PR to: 3.12, 3.13.
🐍🍒⛏🤖

@AA-TurnerAA-Turner deleted the docs/issue-role branch February 27, 2025 19:06
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Feb 27, 2025
@AA-Turner@hugovk@miss-islington
pythonGH-121970: Extractissue_roleinto a new extension (pythonG…
9bc2331
…H-130615) (cherry picked from commit 043ab3a) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
@bedevere-app
Copy link

bedevere-appbot commented Feb 27, 2025

GH-130651 is a backport of this pull request to the 3.13 branch.

@bedevere-appbedevere-appbot removed the needs backport to 3.13 bugs and security fixes label Feb 27, 2025
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Feb 27, 2025
@AA-Turner@hugovk@miss-islington
pythonGH-121970: Extractissue_roleinto a new extension (pythonG…
de65166
…H-130615) (cherry picked from commit 043ab3a) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
@bedevere-app
Copy link

bedevere-appbot commented Feb 27, 2025

GH-130652 is a backport of this pull request to the 3.12 branch.

@bedevere-appbedevere-appbot removed the needs backport to 3.12 only security fixes label Feb 27, 2025
AA-Turner added a commit that referenced this pull request Feb 27, 2025
@miss-islington@AA-Turner@hugovk
[3.13]GH-121970: Extractissue_roleinto a new extension (GH-130615
b53065a
) (#130651) (cherry picked from commit 043ab3a) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
AA-Turner added a commit that referenced this pull request Feb 27, 2025
@miss-islington@AA-Turner@hugovk
[3.12]GH-121970: Extractissue_roleinto a new extension (GH-130615
245ca26
) (#130652) (cherry picked from commit 043ab3a) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@hugovkhugovkhugovk approved these changes

Assignees

No one assigned

Labels

docsDocumentation in the Doc dirskip news

Projects

Docs PRs
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@AA-Turner@hugovk