diff --git a/doc/langref.html.in b/doc/langref.html.in
index 622a3aeb60..a98705afd5 100644
--- a/doc/langref.html.in
+++ b/doc/langref.html.in
@@ -2026,9 +2026,9 @@ fn foo(bytes: []u8) u32 {
       {#header_open|allowzero#}
       <p>
       This pointer attribute allows a pointer to have address zero. This is only ever needed on the
-      freestanding OS target, where the address zero is mappable. In this code example, if the pointer
-      did not have the {#syntax#}allowzero{#endsyntax#} attribute, this would be a
-      {#link|Pointer Cast Invalid Null#} panic:
+      freestanding OS target, where the address zero is mappable. If you want to represent null pointers, use
+      {#link|Optional Pointers#} instead. In this code example, if the pointer did not have the
+      {#syntax#}allowzero{#endsyntax#} attribute, this would be a {#link|Pointer Cast Invalid Null#} panic:
       </p>
       {#code_begin|test|allowzero#}
 const std = @import("std");