diff --git a/doc/langref.html.in b/doc/langref.html.in
index 7b3d7f3dd1..f552d34567 100644
--- a/doc/langref.html.in
+++ b/doc/langref.html.in
@@ -7220,6 +7220,8 @@ test "@setRuntimeSafety" {
     }
 }
       {#code_end#}
+      <p>Note: it is <a href="https://github.com/ziglang/zig/issues/978">planned</a> to replace
+      {#syntax#}@setRuntimeSafety{#endsyntax#} with <code>@optimizeFor</code></p>
 
       {#header_close#}