Several corrections

Author: chenglou

pages/docs/manual/latest/converting-from-js.mdx

@@ -59,7 +59,7 @@ let queryResult = (usePayload, payload) =>
 
 You might still occasionally get syntax errors, but not as drastic as the previous step's.
 
-- Change `foo.bar` to `foo["bar"]`. This escape-hatch [ReScript feature](/docs/reason-compiler/latest/object) will be your medium-term friend.
+- Change `foo.bar` to `foo["bar"]`. This escape-hatch [ReScript feature](object.md) will be your medium-term friend.
 - To communicate with external JS files, use `external`. They're our [foreign function interface](external.md).
   - Inline externals. No need to create clean, well-separated files for externals for now. We'll come back to these.
   - If it's too cumbersome to correctly type an `external`'s input/output, use some placeholder polymorphic types, e.g. `external getStudentById: 'whatever => 'whateverElse = ...`.
@@ -75,7 +75,7 @@ let defaultId = 10
 
 let queryResult = (usePayload, payload) =>
   if usePayload {
-    payload["student"] // this will be inferred as `Js.t 'a`
+    payload["student"] // this will be inferred as `Js.t<'a>`
   } else {
     getStudentById(defaultId)
   };

pages/docs/manual/latest/exception.mdx

@@ -7,7 +7,7 @@ Exceptions are just a special kind of variant, thrown in **exceptional** cases (
 <CodeTab labels={["ReScript", "JS Output"]}>
 
 ```res
-let getItem = (theList) =>
+let getItem = (items) =>
   if callSomeFunctionThatThrows() {
     // return the found item here
     1
@@ -23,7 +23,7 @@ let result =
   }
 ```
 ```js
-function getItem(theList) {
+function getItem(items) {
   if (callSomeFunctionThatThrows()) {
     return 1;
   }
@@ -153,7 +153,7 @@ The `obj` here is of type `Js.Exn.t`, intentionally opaque to disallow illegal o
 
 ## Raise a JS Exception
 
-`raise MyException` raises a ReScript exception. To raise a JavaScript exception (whatever your purpose is), use `Js.Exn.raiseError`:
+`raise(MyException)` raises a ReScript exception. To raise a JavaScript exception (whatever your purpose is), use `Js.Exn.raiseError`:
 
 <CodeTab labels={["ReScript", "JS Output"]}>
 

pages/docs/manual/latest/faq.mdx

@@ -20,6 +20,10 @@ Reason is a syntax layer for OCaml that BuckleScript also adopted. The current R
 
 Please see our [blog post](https://reasonml.org/blog/a-note-on-bucklescripts-future-commitments) on this matter.
 
+**Where can I see the docs in old Reason syntax?**
+
+Switch the doc version to `v8.0.0` in the sidebar on the left!
+
 **Will ReScript support native compilation eventually?**
 
 Our focus is a solid JS story right now. In the future, if there’s strong demand, we might consider it.

pages/docs/manual/latest/function.mdx

@@ -458,8 +458,8 @@ let add = (~first: int=1, ~second: int=2) : int => first + second
 // optional
 let add = (~first as x: option<int>=?, ~second as y: option<int>=?) : int => switch x {...}
 // with punning sugar
-// note that the caller would pass an `int`, not `option int`
-// Inside the function, `first` and `second` are `option int`.
+// note that the caller would pass an `int`, not `option<int>`
+// Inside the function, `first` and `second` are `option<int>`.
 let add = (~first: option<int>=?, ~second: option<int>=?) : int => switch first {...}
 ```
 

pages/docs/manual/latest/import-from-export-to-js.mdx

@@ -94,7 +94,7 @@ Technically, since a ReScript file maps to a module, there's no such thing as "d
 <CodeTab labels={["ReScript", "JS Output"]}>
 
 ```res
-/* FavoriteStudent.ml */
+/* FavoriteStudent.res */
 let default = "Bob"
 ```
 ```js

pages/docs/manual/latest/migrate-from-bucklescript-reason.mdx

@@ -7,11 +7,11 @@ ReScript is a rebranding and cleanup of BuckleScript & Reason that enables us to
 
 ## Upgrade Your Codebase
 
-There are lots of exciting improvements in the new syntax (features, speed, error messages, etc.). The upgrade is trivial and backward-compatible:
+There are lots of exciting improvements in the new syntax (features, speed, error messages, etc.). The upgrade is trivial, backward-compatible and can be done on a per-file basis:
 
 - Upgrade your project to `bs-platform 8.2.0`.
 - `node_modules/.bin/bsc -format MyFile.re > MyFile.res`
 
-**That's it**! You can convert over your files one by one. `MyFile.re` could be any `.re`, `.rei`, `.ml` and `.mli` file.
+**That's it**! `MyFile.re` could be any `.re`, `.rei`, `.ml` and `.mli` file.
 
 Enjoy the improved experience!

pages/docs/manual/latest/newcomer-examples.mdx

@@ -42,7 +42,7 @@ type universityStudent = {gpa: float}
 
 type response<'studentType> = {
   status: int,
-  student: 'studentType
+  student: 'studentType,
 }
 ```
 ```js
@@ -77,7 +77,7 @@ Or using [record](record.md):
 ```res
 type payload = {
   name: string,
-  age: int
+  age: int,
 }
 
 let student1 = {

pages/docs/manual/latest/object.mdx

@@ -44,7 +44,7 @@ let me = {
 }
 ```
 ```js
-bar me = {
+var me = {
   "age": 5,
   "name": "Big ReScript"
 };

pages/docs/manual/latest/overview.mdx

@@ -19,7 +19,7 @@
 
 | JavaScript              | Us                             |
 | ----------------------- | ------------------------------ |
-| `const x = 5;`          | `let x = 5`                   |
+| `const x = 5;`          | `let x = 5`                    |
 | `var x = y;`            | No equivalent (thankfully)     |
 | `let x = 5; x = x + 1;` | `let x = ref(5); x := x.contents + 1` |
 
@@ -36,7 +36,7 @@
 
 | JavaScript                                            | Us                                             |
 | ----------------------------------------------------- | ---------------------------------------------- |
-| `true`, `false`                                       | Same                                |
+| `true`, `false`                                       | Same                                           |
 | `!true`                                               | Same                                           |
 | <code>&#124;&#124;</code>, `&&`, `<=`, `>=`, `<`, `>` | Same                                           |
 | `a === b`, `a !== b`                                  | Same                                           |
@@ -69,7 +69,7 @@
 
 | JavaScript            | Us                                 |
 | --------------------- | ---------------------------------- |
-| `[1, 2, 3]`           | Same |
+| `[1, 2, 3]`           | Same                               |
 | `myArray[1] = 10`     | Same                               |
 | `[1, "Bob", true]`    | `(1, "Bob", true)` \*              |
 

pages/docs/manual/latest/pipe.mdx

@@ -90,7 +90,7 @@ Assuming we don't need the chaining behavior above, we'd bind to each case this
 @bs.send external filter: (array<'a>, 'a => bool) => array<'a> = "filter"
 
 type request
-external asyncRequest: unit => request = "asyncRequest"
+@bs.val external asyncRequest: unit => request = "asyncRequest"
 @bs.send external setWaitDuration: (request, int) => request = "setWaitDuration"
 @bs.send external send: request => unit = "send"
 ```
@@ -128,7 +128,7 @@ This looks much worse than the JS counterpart! Clean it up visually with pipe:
 ```res
 let result = [1, 2, 3]
   ->map(a => a + 1)
-  ->filter(a => a mod 2 === 0)
+  ->filter(a => mod(a, 2) === 0)
 
 asyncRequest()->setWaitDuration(4000)->send
 ```