more correct syntax and AI instructions

docs/library/number.md

@@ -5,7 +5,7 @@ weight: 20
 type: "docs"
 ---
 
-The `number` function and its methods handle numeric conversion and operations.
+The `number` function is an intrinsic (always available, no `use()` needed). It is **polymorphic** — its behavior depends on the type of the first argument.
 
 ## Conversion
 
@@ -123,20 +123,20 @@ Get the fractional part.
 fraction(4.75)  // 0.75
 ```
 
-### min(...values)
+### min(a, b)
 
-Return the smallest value.
+Return the smaller of two numbers.
 
 ```javascript
-min(3, 1, 4, 1, 5)  // 1
+min(3, 5)  // 3
 ```
 
-### max(...values)
+### max(a, b)
 
-Return the largest value.
+Return the larger of two numbers.
 
 ```javascript
-max(3, 1, 4, 1, 5)  // 5
+max(3, 5)  // 5
 ```
 
 ### remainder(dividend, divisor)