diff --git a/docs/annotating_code/type_syntax/scalar_types.md b/docs/annotating_code/type_syntax/scalar_types.md
index ff99acc7e..e0f058e35 100644
--- a/docs/annotating_code/type_syntax/scalar_types.md
+++ b/docs/annotating_code/type_syntax/scalar_types.md
@@ -12,7 +12,7 @@ The type `scalar` is the supertype of all scalar types.
 
 ### positive-int
 
-`positive-int` allows only positive integers
+`positive-int` allows only positive integers (equivalent to `int<1, max>`)
 
 ### numeric