From 78de456ed2570e84503931f7cdc7d7351427290b Mon Sep 17 00:00:00 2001
From: Ralf Jung <post@ralfj.de>
Date: Thu, 6 Aug 2026 14:53:46 +0200
Subject: [PATCH] derive(Diagnostic): link to proper docs

---
 compiler/rustc_macros/src/lib.rs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/compiler/rustc_macros/src/lib.rs b/compiler/rustc_macros/src/lib.rs
index 399f20ebfe1eb..2f4e5606cd555 100644
--- a/compiler/rustc_macros/src/lib.rs
+++ b/compiler/rustc_macros/src/lib.rs
@@ -180,7 +180,7 @@ decl_derive!(
 decl_derive!([Lift, attributes(lift)] => lift::lift_derive);
 decl_derive!(
     [Diagnostic, attributes(
-        // struct attributes
+        // struct and field attributes
         diag,
         help,
         help_once,
@@ -194,7 +194,9 @@ decl_derive!(
         suggestion,
         suggestion_short,
         suggestion_hidden,
-        suggestion_verbose)] => diagnostics::diagnostic_derive
+        suggestion_verbose)] =>
+        #[doc = "See <https://rustc-dev-guide.rust-lang.org/diagnostics/diagnostic-structs.html#derivediagnostic>"]
+        diagnostics::diagnostic_derive
 );
 decl_derive!(
     [Subdiagnostic, attributes(