diff --git a/doc/mkdocs/docs/api/basic_json/operator[].md b/doc/mkdocs/docs/api/basic_json/operator[].md
index 5c480ffc3..cc9eae7f3 100644
--- a/doc/mkdocs/docs/api/basic_json/operator[].md
+++ b/doc/mkdocs/docs/api/basic_json/operator[].md
@@ -74,7 +74,7 @@ Strong exception safety: if an exception occurs, the original value stays intact
 
 ## Notes
 
-!!! danger "Undefined behavior"
+!!! danger "Undefined behavior and runtime assertions"
 
     1. If the element with key `idx` does not exist, the behavior is undefined.
     2. If the element with key `key` does not exist, the behavior is undefined and is **guarded by a
diff --git a/doc/mkdocs/docs/api/macros/json_diagnostics.md b/doc/mkdocs/docs/api/macros/json_diagnostics.md
index 3f73e39bd..d42025092 100644
--- a/doc/mkdocs/docs/api/macros/json_diagnostics.md
+++ b/doc/mkdocs/docs/api/macros/json_diagnostics.md
@@ -26,11 +26,11 @@ When the macro is not defined, the library will define it to its default value.
 
 ## Notes
 
-!!! danger "ODR violation"
+!!! danger "ABI incompatibility"
 
     As this macro changes the definition of the `basic_json` object, it MUST be defined in the same way globally, even
-    across different compilation units; DO NOT link together code compiled with different definitions of
-    `JSON_DIAGNOSTICS` as this is a violation of the One Definition Rule and will cause undefined behaviour.
+    across different compilation units: `basic_json` objects with differently defined `JSON_DIAGNOSTICS` macros are
+    not compatible!
 
 ## Examples