diff --git a/doc/langref.html.in b/doc/langref.html.in
index 4da04f41e8..7c8d1c6662 100644
--- a/doc/langref.html.in
+++ b/doc/langref.html.in
@@ -1300,10 +1300,10 @@ a /= b{#endsyntax#}
Can cause {#link|overflow|Default Operations#} for integers.
Can cause {#link|Division by Zero#} for integers.
Can cause {#link|Division by Zero#} for floats in {#link|FloatMode.Optimized Mode|Floating Point Operations#}.
- For non-compile-time-known signed integers, must use
+ Signed integer operands must be comptime-known and positive. In other cases, use
{#link|@divTrunc#},
{#link|@divFloor#}, or
- {#link|@divExact#} instead of {#syntax#}/{#endsyntax#}.
+ {#link|@divExact#} instead.
Invokes {#link|Peer Type Resolution#} for the operands.
@@ -1325,9 +1325,9 @@ a %= b{#endsyntax#}
- Can cause {#link|Division by Zero#} for integers.
- Can cause {#link|Division by Zero#} for floats in {#link|FloatMode.Optimized Mode|Floating Point Operations#}.
- - For non-compile-time-known signed integers, must use
+
- Signed or floating-point operands must be comptime-known and positive. In other cases, use
{#link|@rem#} or
- {#link|@mod#} instead of {#syntax#}%{#endsyntax#}.
+ {#link|@mod#} instead.
- Invokes {#link|Peer Type Resolution#} for the operands.