diff --git a/docs/topics/compiler-reference.md b/docs/topics/compiler-reference.md
index 8950e6670bb..069ad149aaf 100644
--- a/docs/topics/compiler-reference.md
+++ b/docs/topics/compiler-reference.md
@@ -176,6 +176,11 @@ Treat all warnings as compilation errors.
 Enable [additional declaration, expression, and type compiler checks](whatsnew21.md#extra-compiler-checks) that
 emit warnings if true.
 
+#### -Xrender-internal-diagnostic-names
+<primary-label ref="experimental-general"/>
+
+Prints internal diagnostic names alongside warnings. This is useful for identifying the `DIAGNOSTIC_NAME` configured for the `-Xwarning-level` option.
+
 #### -Xwarning-level
 <primary-label ref="experimental-general"/>
 
@@ -199,6 +204,8 @@ You can adjust warning reporting in your project by combining module-wide rules
 
 If you have many warnings to exclude from the general rules, you can list them in a separate file using [`@argfile`](#argfile).
 
+You can use [`-Xrender-internal-diagnostic-names`](#xrender-internal-diagnostic-names) to discover the `DIAGNOSTIC_NAME`.
+
 ### -Xdata-flow-based-exhaustiveness
 <primary-label ref="experimental-general"/>