fix all doc examples

Author: aspeddro

src/Core__Array.resi

@@ -36,7 +36,7 @@ let make: (~length: int, 'a) => array<'a>
   Creates an array of length `length` initialized with the value returned from `f ` for each index.
 
   ```res example
-  Array.make(~length=3, i => i + 3) == [3, 4, 5]
+  Array.fromInitializer(~length=3, i => i + 3) == [3, 4, 5]
   ```
 */
 let fromInitializer: (~length: int, int => 'a) => array<'a>
@@ -622,8 +622,11 @@ type languages = ReScript | TypeScript | JavaScript
 
 let array = [ReScript, JavaScript]
 
-Console.log(array->Array.findIndexWithIndex((item, index) => index === 0 && item == ReScript)) // 0
-Console.log(array->Array.findIndex((item, index) => index === 0 && item == TypeScript)) // -1
+let isReScriptFirst = array->Array.findIndexWithIndex((item, index) => index === 0 && item == ReScript)
+let isTypeScriptFirst = array->Array.findIndexWithIndex((item, index) => index === 0 && item == TypeScript)
+
+Console.log(isReScriptFirst) // 0
+Console.log(isTypeScriptFirst) // -1
 ```
 */
 @send
@@ -739,7 +742,7 @@ let reduceRight: (array<'a>, 'b, ('b, 'a) => 'b) => 'b
   Like `reduceRight`, but with an additional index argument on the callback function.
 
   ```res example
-  Array.reduceRightWithIndex([1, 2, 3, 4], 0, (acc, x, i) => acc + x + i, 0) == 16
+  Array.reduceRightWithIndex([1, 2, 3, 4], 0, (acc, x, i) => acc + x + i) == 16
   ```
 */
 let reduceRightWithIndex: (array<'a>, 'b, ('b, 'a, int) => 'b) => 'b
@@ -818,6 +821,7 @@ Use `Array.getUnsafe` only when you are sure the `index` exists (i.e. when using
 
 ## Examples
 ```rescript
+let array = [1, 2, 3]
 for index in 0 to array->Array.length - 1 {
   let value = array->Array.getUnsafe(index)
   Console.log(value)
@@ -971,7 +975,7 @@ external flatMap: (array<'a>, 'a => array<'b>) => array<'b> = "flatMap"
   Otherwise returns `None`
 
   ```res example
-  Array.findMap([1, 2, 3], n => mod(n, 2) ? Some(n - 2) : None) == 0
+  Array.findMap([1, 2, 3], n => mod(n, 2) == 0 ? Some(n - 2) : None) == Some(0) // true
   ```
 */
 let findMap: (array<'a>, 'a => option<'b>) => option<'b>

src/Core__AsyncIterator.resi

@@ -29,7 +29,8 @@ See [async iterator protocols](https://developer.mozilla.org/en-US/docs/Web/Java
 ## Examples
 - A simple example, getting the next value:
 ```rescript
-let {done, value} = await someAsyncIterator->AsyncIterator.next
+@val external asyncIterator: AsyncIterator.t<int> = "someAsyncIterator"
+let {AsyncIterator.done, value} = await asyncIterator->AsyncIterator.next
 ```
 
 - Complete example, including looping over all values:

src/Core__Console.resi

@@ -14,7 +14,7 @@ on MDN.
 
 ```rescript
 Console.assert_(false, "Hello World!")
-Console.assert_(n == 42, "The answer")
+Console.assert_(42 == 42, "The answer")
 ```
 */
 @val
@@ -27,7 +27,7 @@ external assert_: (bool, 'a) => unit = "console.assert"
 
 ```rescript
 Console.assert2(false, "Hello", "World")
-Console.assert2(n == 42, [1, 2, 3], '4')
+Console.assert2(42 == 42, [1, 2, 3], '4')
 ```
 */
 @val
@@ -40,7 +40,7 @@ external assert2: (bool, 'a, 'b) => unit = "console.assert"
 
 ```rescript
 Console.assert3(false, "Hello", "World", "ReScript")
-Console.assert3(n == 42, "One", 2, #3)
+Console.assert3(42 == 42, "One", 2, #3)
 ```
 */
 @val
@@ -52,8 +52,9 @@ external assert3: (bool, 'a, 'b, 'c) => unit = "console.assert"
 ## Examples
 
 ```rescript
+let value = 42
 Console.assert4(false, "Hello", "World", "ReScript", "!!!")
-Console.assert4(m == 42, [1, 2], (3, 4), [#5, #6], #"polyvar")
+Console.assert4(value == 42, [1, 2], (3, 4), [#5, #6], #"polyvar")
 ```
 */
 @val
@@ -65,8 +66,9 @@ external assert4: (bool, 'a, 'b, 'c, 'd) => unit = "console.assert"
 ## Examples
 
 ```rescript
+let value = 42
 Console.assert5(false, "Hello", "World", "JS", '!', '!')
-Console.assert5(n == 42, [1, 2], (3, 4), [#5, #6], #"polyvar", {"name": "ReScript"})
+Console.assert5(value == 42, [1, 2], (3, 4), [#5, #6], #"polyvar", {"name": "ReScript"})
 ```
 */
 @val
@@ -78,8 +80,9 @@ external assert5: (bool, 'a, 'b, 'c, 'd, 'e) => unit = "console.assert"
 ## Examples
 
 ```rescript
+let value = 42
 Console.assert6(false, "Hello", "World", "JS", '!', '!', '?')
-Console.assert6(n == 42, [1, 2], (3, 4), [#5, #6], #"polyvar", {"name": "ReScript"}, 42)
+Console.assert6(value == 42, [1, 2], (3, 4), [#5, #6], #"polyvar", {"name": "ReScript"}, 42)
 ```
 */
 @val
@@ -91,8 +94,9 @@ external assert6: (bool, 'a, 'b, 'c, 'd, 'e, 'f) => unit = "console.assert"
 ## Examples
 
 ```rescript
+let value = 42
 Console.assertMany(false, ["Hello", "World"])
-Console.assertMany(n == 42, [1, 2, 3])
+Console.assertMany(value == 42, [1, 2, 3])
 ```
 */
 @val
@@ -249,7 +253,7 @@ on MDN.
 ## Examples
 
 ```rescript
-Console.dir({"language": "rescript", "version": 10.1.2})
+Console.dir({"language": "rescript", "version": "10.1.2"})
 ```
 */
 @val
@@ -325,7 +329,7 @@ external error4: ('a, 'b, 'c, 'd) => unit = "console.error"
 ## Examples
 
 ```rescript
-Console.error5('e', 'r, 'r', 'o', 'r')
+Console.error5('e', 'r', 'r', 'o', 'r')
 Console.error5(1, #second, #third, ("fourth"), 'c')
 ```
 */
@@ -597,7 +601,7 @@ on MDN.
 ## Examples
 
 ```rescript
-Console.table({"language": "rescript", "version": 10.1.2})
+Console.table({"language": "rescript", "version": "10.1.2"})
 ```
 */
 @val

src/Core__Date.resi

@@ -67,20 +67,15 @@ You can use the result like any valid date, but many functions like `toString` w
 
 ## Examples
 ```rescript
-Date.fromString("2023")
-// 2023-01-01T00:00:00.000Z
+Date.fromString("2023") // 2023-01-01T00:00:00.000Z
 
-Date.fromString("2023-02-20")
-// 2023-02-20T00:00:00.000Z
+Date.fromString("2023-02-20") // 2023-02-20T00:00:00.000Z
 
-Date.fromString("2023-02-20T16:40:00.00Z")
-// 2023-02-20T16:40:00.000Z
+Date.fromString("2023-02-20T16:40:00.00Z") // 2023-02-20T16:40:00.000Z
 
-Date.fromString("")
-// Invalid Date
+Date.fromString("") // Invalid Date
 
-Date.fromString("")->getTime
-// NaN
+Date.fromString("")->Date.getTime // NaN
 ```
 */
 @new
@@ -801,8 +796,7 @@ Returns the year of a given date (according to UTC time).
 
 ## Examples
 ```rescript
-Date.fromString("2023-01-01T00:00:00.00+01:00").getUTCFullYear
-// 2022
+Date.fromString("2023-01-01T00:00:00.00+01:00")->Date.getUTCFullYear // 2022
 ```
 */
 @send
@@ -815,8 +809,7 @@ Returns the month of a given date (according to UTC time).
 
 ## Examples
 ```rescript
-Date.fromString("2023-01-01T00:00:00.00+01:00").getUTCMonth
-// 11
+Date.fromString("2023-01-01T00:00:00.00+01:00")->Date.getUTCMonth // 11
 ```
 */
 @send
@@ -829,8 +822,7 @@ Returns the date (day of month) of a given date (according to UTC time).
 
 ## Examples
 ```rescript
-Date.fromString("2023-01-01T00:00:00.00+01:00").getUTCDate
-// 31
+Date.fromString("2023-01-01T00:00:00.00+01:00")->Date.getUTCDate // 31
 ```
 */
 @send
@@ -843,8 +835,7 @@ Returns the hours of a given date (according to UTC time).
 
 ## Examples
 ```rescript
-Date.fromString("2023-01-01T00:00:00.00+01:00").getUTCHours
-// 23
+Date.fromString("2023-01-01T00:00:00.00+01:00")->Date.getUTCHours // 23
 ```
 */
 @send
@@ -857,8 +848,7 @@ Returns the minutes of a given date (according to UTC time).
 
 ## Examples
 ```rescript
-Date.fromString("2023-01-01T00:00:00.00+01:00").getUTCMinutes
-// 0
+Date.fromString("2023-01-01T00:00:00.00+01:00")->Date.getUTCMinutes // 0
 ```
 */
 @send
@@ -871,8 +861,7 @@ Returns the seconds of a given date (according to UTC time).
 
 ## Examples
 ```rescript
-Date.fromString("2023-01-01T00:00:00.00+01:00").getUTCSeconds
-// 0
+Date.fromString("2023-01-01T00:00:00.00+01:00")->Date.getUTCSeconds // 0
 ```
 */
 @send
@@ -885,8 +874,7 @@ Returns the milliseconds of a given date (according to UTC time).
 
 ## Examples
 ```rescript
-Date.fromString("2023-01-01T00:00:00.00+01:00").getUTCMilliseconds
-// 0
+Date.fromString("2023-01-01T00:00:00.00+01:00")->Date.getUTCMilliseconds // 0
 ```
 */
 @send
@@ -900,8 +888,7 @@ Returns the day (day of week) of a given date (according to UTC time).
 
 ## Examples
 ```rescript
-Date.fromString("2023-01-01T00:00:00.00+01:00").getUTCDay
-// 6
+Date.fromString("2023-01-01T00:00:00.00+01:00")->Date.getUTCDay // 6
 ```
 */
 @send

src/Core__Dict.resi

@@ -17,11 +17,9 @@ Use `Dict.getUnsafe` only when you are sure the key exists (i.e. when iterating
 
 ## Examples
 ```rescript
-let keys = dict->Dict.keys
-keys->Array.forEach(key => {
-  let value = dict->Dict.getUnsafe(key)
-  Console.log(value)
-})
+let dict = Dict.fromArray([("key1", "value1"), ("key2", "value2")])
+let value = dict->Dict.getUnsafe("key1")
+Console.log(value) // value1
 ```
 */
 @get_index

src/Core__Error.resi

@@ -28,7 +28,8 @@ See [`Error.prototype.stack`](https://developer.mozilla.org/en-US/docs/Web/JavaS
 
 ## Example
 ```rescript
-Console.log(someError->Error.stack) // Logs `stack` if it exists on `someError`
+let error = Error.make("error")
+Console.log(error->Error.stack) // Logs `stack` if it exists on `someError`
 ```
 */
 @get

src/Core__Float.resi

@@ -153,7 +153,7 @@ See [`parseFloat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Refer
 ```rescript
 Float.parseFloat("1.0") // 1.0
 Float.parseFloat("  3.14   ") // 3.14
-Float.parseFloat(3.0) // 3.0
+Float.parseFloat("3.0") // 3.0
 Float.parseFloat("3.14some non-digit characters") // 3.14
 Float.parseFloat("error")->Float.isNaN // true
 ```
@@ -190,10 +190,10 @@ See [`parseInt`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Referen
 ## Examples
 
 ```rescript
-Float.parseInt("10.0", ~radix=2) // 2.0
-Float.parseInt("15 * 3", ~radix=10) // 15.0
-Float.parseInt("12", ~radix=13) // 15.0
-Float.parseInt("17", ~radix=40)->Float.isNaN // true
+Float.parseIntWithRadix("10.0", ~radix=2) // 2.0
+Float.parseIntWithRadix("15 * 3", ~radix=10) // 15.0
+Float.parseIntWithRadix("12", ~radix=13) // 15.0
+Float.parseIntWithRadix("17", ~radix=40)->Float.isNaN // true
 ```
 */
 @val
@@ -258,8 +258,8 @@ See [`Number.toFixed`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/R
 ## Examples
 
 ```rescript
-Float.toFixed(300.0, ~digits=4) // "300.0000"
-Float.toFixed(300.0, ~digits=1) // "300.0"
+Float.toFixedWithPrecision(300.0, ~digits=4) // "300.0000"
+Float.toFixedWithPrecision(300.0, ~digits=1) // "300.0"
 ```
 
 ## Exceptions
@@ -286,15 +286,15 @@ Float.toPrecision(1.0) // "1"
 external toPrecision: float => string = "toPrecision"
 
 /**
-`toPrecision(v, ~digits)` return a `string` representing the giver value with
+`toPrecisionWithPrecision(v, ~digits)` return a `string` representing the giver value with
 precision. `digits` specifies the number of significant digits.
 See [`Number.toPrecision`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/toPrecision) on MDN.
 
 ## Examples
 
 ```rescript
-Float.toPrecision(100.0, ~digits=2) // "1.0e+2"
-Float.toPrecision(1.0) // "1.0"
+Float.toPrecisionWithPrecision(100.0, ~digits=2) // "1.0e+2"
+Float.toPrecisionWithPrecision(1.0, ~digits=1) // "1"
 ```
 
 ## Exceptions
@@ -329,8 +329,8 @@ See [`Number.toString`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/
 ## Examples
 
 ```rescript
-Float.toString(6.0, ~radix=2) // "110"
-Float.toString(3735928559.0, ~radix=16) // "deadbeef"
+Float.toStringWithRadix(6.0, ~radix=2) // "110"
+Float.toStringWithRadix(3735928559.0, ~radix=16) // "deadbeef"
 Float.toStringWithRadix(123456.0, ~radix=36) // "2n9c"
 ```
 
@@ -350,10 +350,10 @@ See [`Number.toLocaleString`](https://developer.mozilla.org/en-US/docs/Web/JavaS
 
 ```rescript
 // If the application uses English as the default language
-Int.toLocaleString(1000.0) // "1,000"
+Float.toLocaleString(1000.0) // "1,000"
 
 // If the application uses Portuguese Brazil as the default language
-Int.toLocaleString(1000.0) // "1.000"
+Float.toLocaleString(1000.0) // "1.000"
 ```
 */
 @send
@@ -404,7 +404,7 @@ external fromInt: int => float = "%identity"
 ## Examples
 
 ```rescript
-Int.mod(7.0, 4.0) == 3
+Float.mod(7.0, 4.0) == 3.0
 ```
 */
 external mod: (float, float) => float = "?fmod_float"
@@ -417,10 +417,10 @@ if `max` < `min` returns `min`.
 ## Examples
 
 ```rescript
-Int.clamp(4.2) == 4.2
-Int.clamp(4.2, ~min=4.3) == 4.3
-Int.clamp(4.2, ~max=4.1) == 4.1
-Int.clamp(4.2, ~min=4.3, ~max=4.1) == 4.3
+Float.clamp(4.2) == 4.2
+Float.clamp(4.2, ~min=4.3) == 4.3
+Float.clamp(4.2, ~max=4.1) == 4.1
+Float.clamp(4.2, ~min=4.3, ~max=4.1) == 4.3
 ```
 */
 let clamp: (~min: float=?, ~max: float=?, float) => float