Skip to content

Standardize translation of Doc/bugs.rst #137449

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
merged 2 commits into from
Oct 17, 2025
Merged

Standardize translation of Doc/bugs.rst #137449

merged 2 commits into from
Oct 17, 2025

Conversation

StanFromIreland
Copy link
Member

@StanFromIreland StanFromIreland commented Aug 6, 2025 •
edited
Loading

PEP 545 (and soon, the devguide with my PR) states that:

... bugs.html [should be translated] with proper links to the language repository issue tracker.

There is however, no clear way of doing this, and it is sometimes not added at all. I therefore propose to add a section that will only appear in translations and the gettext builder, that will allow for this to be standardized.

The tag will also be useful in other places, namely @nedbat's "Improve this page" page (#136246)

I have verified that this will work with docsbuild-scripts.

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

@StanFromIreland StanFromIreland mentioned this pull request Aug 6, 2025
Open
@StanFromIreland StanFromIreland mentioned this pull request Oct 1, 2025
Open
@adorilson
Copy link
Contributor

Amazing.

Often, I miss information that only makes sense in translations.

m-aciek
m-aciek approved these changes Oct 1, 2025
View reviewed changes
Copy link
Contributor

@m-aciek m-aciek left a comment

Choose a reason for hiding this comment

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

I like this approach. It makes the translation consistent.

It's worth noting, that as a follow-up PEP 545 should have "proper links to the language repository issue tracker" note removed.

JulienPalard
JulienPalard reviewed Oct 16, 2025
View reviewed changes
@JulienPalard JulienPalard merged commit 869bb69 into python:main Oct 17, 2025
31 checks passed
@JulienPalard
Copy link
Member

Nice idea, thanks @StanFromIreland !

@StanFromIreland
Copy link
Member Author

Thanks Julien!

Also, you may have missed it but the Python Docs Sphinx theme supports translation and is missing French!

@StanFromIreland StanFromIreland deleted the standardize-bugs-translation branch October 17, 2025 06:57
@JulienPalard
Copy link
Member

Also, you may have missed it but the Python Docs Sphinx theme supports translation and is missing French!

I've seen some emails about it yes, but dad effect.

@StanFromIreland
Copy link
Member Author

WDYT about backporting this pr, since it is just docs?

@JulienPalard
Copy link
Member

Dunno, maybe just on 3.14 to have it on docs.python.org/3/, but I don't feel it's "needed" more than that, what do you think?

@StanFromIreland
Copy link
Member Author

I think just backporting to 3.14 is fine.

@StanFromIreland StanFromIreland added the needs backport to 3.14 bugs and security fixes label Oct 17, 2025
@miss-islington-app
Copy link

Thanks @StanFromIreland for the PR, and @JulienPalard for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14.
🐍🍒⛏🤖

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Oct 17, 2025
@StanFromIreland @miss-islington
Standardize translation of Doc/bugs.rst (pythonGH-137449)
59a2055 
(cherry picked from commit 869bb69)

Co-authored-by: Stan Ulbrych <[email protected]>
@bedevere-app
Copy link

bedevere-app bot commented Oct 17, 2025

GH-140275 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.14 bugs and security fixes label Oct 17, 2025
@StanFromIreland
Copy link
Member Author

Translations have been rebuilt and the message has appeared (and importantly, it is not present in the English build), for example Polish!

@hugovk
Copy link
Member

hugovk commented Oct 18, 2025

Let's also backport to 3.13, so we don't get conflicts when backporting other fixes, especially as this updates conf.py.

@StanFromIreland StanFromIreland added the needs backport to 3.13 bugs and security fixes label Oct 18, 2025
@miss-islington-app
Copy link

Thanks @StanFromIreland for the PR, and @JulienPalard for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Oct 18, 2025
@StanFromIreland @miss-islington
Standardize translation of Doc/bugs.rst (pythonGH-137449)
c038c74 
(cherry picked from commit 869bb69)

Co-authored-by: Stan Ulbrych <[email protected]>
@bedevere-app
Copy link

bedevere-app bot commented Oct 18, 2025

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

@bedevere-app bedevere-app bot removed the needs backport to 3.13 bugs and security fixes label Oct 18, 2025
JulienPalard pushed a commit that referenced this pull request Oct 19, 2025
@miss-islington @StanFromIreland
[3.14] Standardize translation of Doc/bugs.rst (GH-137449) (#140275)
13e1642 
Standardize translation of `Doc/bugs.rst` (GH-137449)
(cherry picked from commit 869bb69)

Co-authored-by: Stan Ulbrych <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@JulienPalard JulienPalard JulienPalard approved these changes

@AA-Turner AA-Turner Awaiting requested review from AA-Turner AA-Turner is a code owner

@hugovk hugovk Awaiting requested review from hugovk hugovk is a code owner

@willingc willingc Awaiting requested review from willingc

+1 more reviewer

@m-aciek m-aciek m-aciek approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

skip issue skip news

Projects

Translation issues & improvements 🌍
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@StanFromIreland @adorilson @JulienPalard @hugovk @m-aciek