From: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Date: Fri, 17 Oct 2025 06:55:12 +0000 (+0100)
Subject: Standardize translation of `Doc/bugs.rst` (GH-137449)
X-Git-Tag: v3.15.0a2~411
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=869bb6948eb501b19db53cb27c523c3203a5ab11;p=thirdparty%2FPython%2Fcpython.git

Standardize translation of `Doc/bugs.rst` (GH-137449)
---

diff --git a/Doc/bugs.rst b/Doc/bugs.rst
index faf13eeb6a7c..0683eebbaf67 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
 # --------------------------------