fix docstrings examples - part 2

Author: aspeddro

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

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__Float.resi

@@ -404,7 +404,7 @@ external fromInt: int => float = "%identity"
 ## Examples
 
 ```rescript
-Float.mod(7.0, 4.0) == 3
+Float.mod(7.0, 4.0) == 3.0
 ```
 */
 external mod: (float, float) => float = "?fmod_float"

src/Core__Int.resi

@@ -155,7 +155,7 @@ precision. `digits` specifies the number of significant digits. See [`Number.toP
 
 ```rescript
 Int.toPrecisionWithPrecision(100, ~digits=2) // "1.0e+2"
-Int.toPrecisionWithPrecision(1) // "1.0"
+Int.toPrecisionWithPrecision(1, ~digits=2) // "1.0"
 ```
 
 ## Exceptions

src/Core__Iterator.resi

@@ -30,8 +30,9 @@ See [iterator protocols](https://developer.mozilla.org/en-US/docs/Web/JavaScript
 
 ## Examples
 ```rescript
+@val external someIterator: Iterator.t<int> = "someIterator"
 // Pulls out the next value of the iterator
-let {done, value} = someIterator->Iterator.next
+let {Iterator.done, value} = someIterator->Iterator.next
 ```
 */
 @send

src/Core__Map.resi

@@ -89,10 +89,10 @@ Clears all entries in the map.
 let map = Map.make()
 
 map->Map.set("someKey", "someValue")
-let size = map->Map.size // 1
+map->Map.size // 1
 
 map->Map.clear
-let size = map->Map.size // 0
+map->Map.size // 0
 ```
 */
 @send

src/Core__Null.resi

@@ -90,10 +90,10 @@ Null.getOr(Null.null, "Banana") // Banana
 Null.getOr(Null.make("Apple"), "Banana") // Apple
 
 let greet = (firstName: option<string>) =>
-  "Greetings " ++ firstName->Null.getOr("Anonymous")
+  "Greetings " ++ firstName->Option.getOr("Anonymous")
 
-Null.make("Jane")->greet // "Greetings Jane"
-null->greet // "Greetings Anonymous"
+Null.make("Jane")->Null.toOption->greet // "Greetings Jane"
+Null.null->Null.toOption->greet // "Greetings Anonymous"
 ```
 */
 let getOr: (t<'a>, 'a) => 'a

src/Core__Nullable.resi

@@ -98,13 +98,13 @@ otherwise return `default`.
 
 ```rescript
 Nullable.getOr(Nullable.null, "Banana") // Banana
-Nullable.getOr(Nulalble.make("Apple"), "Banana") // Apple
+Nullable.getOr(Nullable.make("Apple"), "Banana") // Apple
 
 let greet = (firstName: option<string>) =>
-  "Greetings " ++ firstName->Nullable.getOr("Anonymous")
+  "Greetings " ++ firstName->Option.getOr("Anonymous")
 
-Nullable.make("Jane")->greet // "Greetings Jane"
-Nullable.null->greet // "Greetings Anonymous"
+Nullable.make("Jane")->Nullable.toOption->greet // "Greetings Jane"
+Nullable.null->Nullable.toOption->greet // "Greetings Anonymous"
 ```
 */
 let getOr: (t<'a>, 'a) => 'a

src/Core__Object.res

@@ -165,9 +165,9 @@ external keysToArray: {..} => array<string> = "Object.keys"
 
 ```rescript
 let point = {"x": 1, "y": 2}
-{"a": 1}->hasOwnProperty("a") // true
-{"a": 1}->hasOwnProperty("b") // false
-{"a": 1}->hasOwnProperty("toString") // false
+{"a": 1}->Object.hasOwnProperty("a") // true
+{"a": 1}->Object.hasOwnProperty("b") // false
+{"a": 1}->Object.hasOwnProperty("toString") // false
 ```
 */
 @val

src/Core__Promise.resi

@@ -65,7 +65,7 @@ Promise.make((resolve, reject) => {
 ->then(str => {
   Console.log(str)->resolve
 })
-->catch(e => {
+->catch(_ => {
   Console.log("Error occurred")
   resolve()
 })
@@ -127,7 +127,8 @@ See [`Promise.then`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Ref
 ## Examples
 
 ```rescript
-Promise.resolve(5)
+open Promise
+resolve(5)
 ->then(num => {
   resolve(num + 5)
 })
@@ -149,6 +150,7 @@ within the provided callback (e.g. `thenResolve(value => resolve(value))`).
 ## Examples
 
 ```rescript
+open Promise
 resolve("Anna")
 ->thenResolve(str => {
   "Hello " ++ str
@@ -173,12 +175,13 @@ it originally received. See [`Promise.finally`](https://developer.mozilla.org/en
 ## Examples
 
 ```rescript
+open Promise
 exception SomeError(string)
 let isDone = ref(false)
 
 resolve(5)
 ->then(_ => {
-  reject(TestError("test"))
+  reject(SomeError("test"))
 })
 ->then(v => {
   Console.log2("final result", v)
@@ -211,8 +214,8 @@ external finally: (t<'a>, unit => unit) => t<'a> = "finally"
 open Promise
 let racer = (ms, name) => {
   Promise.make((resolve, _) => {
-    Global.setTimeout(() => {
-      resolve(. name)
+    setTimeout(() => {
+      resolve(name)
     }, ms)->ignore
   })
 }