diff --git a/doc/mkdocs/docs/features/macros.md b/doc/mkdocs/docs/features/macros.md
index 4b41bb85a..809667077 100644
--- a/doc/mkdocs/docs/features/macros.md
+++ b/doc/mkdocs/docs/features/macros.md
@@ -51,7 +51,8 @@ that enabling this macro increases the size of every JSON value by one pointer a
 The diagnostics messages can also be controlled with the CMake option `JSON_Diagnostics` (`OFF` by default) which sets
 `JSON_DIAGNOSTICS` accordingly.
 
-WARNING: This macro changes the definition of exception classes, thus this macro MUST be defined in the same way globally, even across different compilation units, or will cause a violation of the One Definition Rule. No NOT link together code compiled with and without JSON_DIAGNOSTICS defined.
+WARNING: As thus macro changes the definition of the json object, it MUST be defined in the same way globally, even across different compilation units. 
+No NOT link together code compiled with and without JSON_DIAGNOSTICS defined as this is a violation of the One Definition Rule and will cause undefined behaviour.
 
 !!! info "Default behavior"