diff --git a/docs/topics/compiler-reference.md b/docs/topics/compiler-reference.md
index 8950e6670bb..a2b27e8e33f 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"/>
+
+Includes diagnostic names when a warning is printed. Useful for discovering `DIAGNOSTIC_NAME` for [`-Xwarning-level``](#xwarning-level).
+
 #### -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).
 
+`DIAGNOSTIC_NAME`s can be discovered via [`-Xrender-internal-diagnostic-names`](#xrender-internal-diagnostic-names).
+
 ### -Xdata-flow-based-exhaustiveness
 <primary-label ref="experimental-general"/>