diff --git a/doc/langref.html.in b/doc/langref.html.in
index 34fc7681c78c535818b2ee21e70b6d03dbc9ea55..5da26971879a63ed32557a841001dfc495423423 100644
--- a/doc/langref.html.in
+++ b/doc/langref.html.in
@@ -999,7 +999,8 @@ pub fn main() void {
       </p>
       <p>
       In {#link|Debug#} mode, Zig writes {#syntax#}0xaa{#endsyntax#} bytes to undefined memory. This is to catch
-      bugs early, and to help detect use of undefined memory in a debugger.
+      bugs early, and to help detect use of undefined memory in a debugger. However, this behavior is only an
+      implementation feature, not a language semantic, so it is not guaranteed to be observable to code.
       </p>
       {#header_close#}
       {#header_close#}