From 59a2055da8996380db8ad58a9edc845de1c6c55b Mon Sep 17 00:00:00 2001
From: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Date: Fri, 17 Oct 2025 07:55:12 +0100
Subject: [PATCH] Standardize translation of `Doc/bugs.rst` (GH-137449) (cherry
 picked from commit 869bb6948eb501b19db53cb27c523c3203a5ab11)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
---
 Doc/bugs.rst |  6 ++++++
 Doc/conf.py  | 19 +++++++++++++++++++
 2 files changed, 25 insertions(+)

diff --git a/Doc/bugs.rst b/Doc/bugs.rst
index 5d0f68ca69675e..1d27579e53f4ef 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 c1b07df08b1782..a8e376c0ae44fe 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -444,6 +444,25 @@
 # 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
 # --------------------------------