From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sun, 19 Oct 2025 21:13:48 +0000 (+0200)
Subject: [3.14] Standardize translation of `Doc/bugs.rst` (GH-137449) (#140275)
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=13e1642845613fd07a375c8323c898def0d45f6c;p=thirdparty%2FPython%2Fcpython.git

[3.14] Standardize translation of `Doc/bugs.rst` (GH-137449) (#140275)

Standardize translation of `Doc/bugs.rst` (GH-137449)
(cherry picked from commit 869bb6948eb501b19db53cb27c523c3203a5ab11)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
---

diff --git a/Doc/bugs.rst b/Doc/bugs.rst
index 5d0f68ca6967..1d27579e53f4 100644
--- a/Doc/bugs.rst
+++ b/Doc/bugs.rst
@@ -19,6 +19,12 @@ If you find a bug in this documentation or would like to propose an improvement,
 please submit a bug report on the :ref:`issue tracker <using-the-tracker>`.  If you
 have a suggestion on how to fix it, include that as well.
 
+.. only:: translation
+
+   If the bug or suggested improvement concerns the translation of this
+   documentation, submit the report to the
+   `translation’s repository <TRANSLATION_REPO_>`_ instead.
+
 You can also open a discussion item on our
 `Documentation Discourse forum <https://discuss.python.org/c/documentation/26>`_.
 
diff --git a/Doc/conf.py b/Doc/conf.py
index c1b07df08b17..a8e376c0ae44 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -444,6 +444,25 @@ epub_exclude_files = ('index.xhtml', 'download.xhtml')
 # https://github.com/sphinx-doc/sphinx/issues/12359
 epub_use_index = False
 
+# translation tag
+# ---------------
+
+language_code = None
+for arg in sys.argv:
+    if arg.startswith('language='):
+        language_code = arg.split('=', 1)[1]
+
+if language_code:
+    tags.add('translation')  # noqa: F821
+
+    rst_epilog += f"""\
+.. _TRANSLATION_REPO: https://github.com/python/python-docs-{language_code.replace("_", "-").lower()}
+"""  # noqa: F821
+else:
+    rst_epilog += """\
+.. _TRANSLATION_REPO: https://github.com/python
+"""
+
 # Options for the coverage checker
 # --------------------------------