diff --git a/docs/_docs/reference/metaprogramming/macros.md b/docs/_docs/reference/metaprogramming/macros.md
index d8a1893c38bd..25e36e3024bd 100644
--- a/docs/_docs/reference/metaprogramming/macros.md
+++ b/docs/_docs/reference/metaprogramming/macros.md
@@ -4,7 +4,7 @@ title: "Macros"
 nightlyOf: https://docs.scala-lang.org/scala3/reference/metaprogramming/macros.html
 ---
 
-> **Warning:** Always enable `-Xcheck-macros` when developing macros. Without it, the compiler will not validate generated code, which may be unsound and lead to undefined behavior.
+> When developing macros, enable the `-Xcheck-macros` compiler option to run extra safety checks.
 
 ## Multi-Staging
 
diff --git a/docs/_spec/TODOreference/metaprogramming/macros.md b/docs/_spec/TODOreference/metaprogramming/macros.md
index 244fd00eff40..1231271cd21a 100644
--- a/docs/_spec/TODOreference/metaprogramming/macros.md
+++ b/docs/_spec/TODOreference/metaprogramming/macros.md
@@ -4,7 +4,7 @@ title: "Macros"
 nightlyOf: https://docs.scala-lang.org/scala3/reference/metaprogramming/macros.html
 ---
 
-> **Warning:** Always enable `-Xcheck-macros` when developing macros. Without it, the compiler will not validate generated code, which may be unsound and lead to undefined behavior.
+> When developing macros, enable the `-Xcheck-macros` compiler option to run extra safety checks.
 
 ## Multi-Staging