From f456a0ba6f2bab5e260205527c96fa7ec8f430b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=AE=B8=E6=9D=B0=E5=8F=8B=20Jieyou=20Xu=20=28Joe=29?=
 <39484203+jieyouxu@users.noreply.github.com>
Date: Mon, 28 Oct 2024 14:34:53 +0800
Subject: [PATCH] Update current status of diag translation infra

---
 src/diagnostics/translation.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/src/diagnostics/translation.md b/src/diagnostics/translation.md
index d244e004e..58d75f54a 100644
--- a/src/diagnostics/translation.md
+++ b/src/diagnostics/translation.md
@@ -1,5 +1,27 @@
 # Translation
 
+<div class="warning">
+rustc's current diagnostics translation infrastructure (as of
+<!-- date-check --> October 2024
+) unfortunately causes some friction for compiler contributors, and the current
+infrastructure is mostly pending a redesign that better addresses needs of both
+compiler contributors and translation teams. Note that there is no current
+active redesign proposals (as of
+<!-- date-check --> October 2024
+)!
+
+Please see the tracking issue <https://github.com/rust-lang/rust/issues/132181>
+for status updates.
+
+We have downgraded the internal lints `untranslatable_diagnostic` and
+`diagnostic_outside_of_impl`. Those internal lints previously required new code
+to use the current translation infrastructure. However, because the translation
+infra is waiting for a yet-to-be-proposed redesign and thus rework, we are not
+mandating usage of current translation infra. Use the infra if you *want to* or
+otherwise makes the code cleaner, but otherwise sidestep the translation infra
+if you need more flexibility.
+</div>
+
 rustc's diagnostic infrastructure supports translatable diagnostics using
 [Fluent].