Merge pull request rescript-lang#293 from rescript-association/upgrade-to-9

Upgrade docs to 8.3, 8.4 and then to 9.x

Author: ryyppy

.gitignore

@@ -11,6 +11,8 @@ node_modules/
 .next/
 index_data/*.json
 
+pages/docs/manual/v8.0.0/
+
 yarn-error.log
 
 .bsb.lock

_blogposts/2020-12-07-release-8-4.mdx

@@ -55,30 +55,9 @@ dependent's command line flags for building binary artifacts. Such strategy bene
 
 ### Introducing `pinned-dependencies`
 
-To make `bsb -make-world` more practical, we also introduce a new concept called: `pinned-dependencies`.
-In general, packages are classified as three categories:
-
-- toplevel
-  - warnings reported
-  - warn-error respected
-  - build dev dependency
-  - run custom rules
-  - package-specs like ES6/CommonJS overrides all its dependencies
-- pinned dependencies
-  - warnings reported
-  - warn-error respected
-  - build dev dependency
-  - run custom rules
-- normal dependencies
-  - warnings, warn-error ignored
-  - ignore dev directories
-  - ignore custom generator rules
-
-Previously, we only had `toplevel` and `normal dependencies`, by introducing `pinned-dependencies`,
-such package will be built mostly like `toplevel` packages.
-
-The usage is quite simple, add `pinned-dependencies` in the toplevel package's `bsconfig.json`.
-Note such field only make sense in toplevel's configuration.
+To make `bsb -make-world` more practical for e.g. multi-package setups (`lerna`, `yarn workspaces`, etc.), we introduced a new concept called `pinned-dependencies`. A pinned dependency allows you to automatically rebuild packages that are pinned by a toplevel package, like your final webapp.
+
+Please refer to our [pinned dependencies](/docs/manual/latest/build-pinned-dependencies) docs for more details.
 
 ### More robust handling of removal of staled output
 

_blogposts/2021-02-09-release-9-0.mdx

@@ -35,48 +35,8 @@ Our compiler comes with a set of stdlib modules (such as `Belt`, `Pervasives`, e
 
 In previous versions, users couldn't ship their compiled JS code without defining a `package.json` dependency on `bs-platform`. Whenever a ReScript developer wanted to publish a package just for pure JS consumption / lean container deployment, they were required to use a bundler to bundle up their library / stdlib code, which made things way more complex and harder to understand.
 
-To fix this problem, we now publish our pre-compiled stdlib JS files as a separate npm package called [`@rescript/std`](https://www.npmjs.com/package/@rescript/std). Each new `bs-platform` release has a matching `@rescript/std` release for runtime compatibility.
 
-We also introduced a new configuration within our `bsconfig.json` file to tell the compiler to use our pre-compiled package instead:
-
-```json
-{
-  /* ... */
-  "external-stdlib" : "@rescript/std"
-}
-```
-
-With this configuration set, compiled JS code will now point to the defined `external-stdlib` path:
-
-<CodeTab labels={["ReScript", "JavaScript"]}>
-
-```res
-Belt.Array.forEach([1, 2, 3], (num) => Js.log(num))
-```
-
-```js
-// Note the import path starting with "@rescript/std"
-import * as Belt_Array from "@rescript/std/lib/es6/belt_Array.js";
-
-Belt_Array.forEach([
-      1,
-      2,
-      3
-    ], (function (num) {
-        console.log(num);
-        
-      }));
-```
-
-</CodeTab>
-
-The JavaScript output above was compiled with an `es6` target, but will also work with `commonjs`.
-
-**Important:** When using this option, you need to make sure that the version number of `bs-platform` and `@rescript/std` matches with the same version number in your `package.json` file, otherwise you'll eventually run into runtime problems due to mismatching stdlib behavior!
-
-To prevent unnecessary complications, only use this feature when...
-- You want to ship a library for JS / TS consumers without making them depend on `bs-platform`
-- You can't depend on `bs-platform` due to toolchain size (docker containers, low-storage deployment devices, etc)
+To fix this problem, we introduced an `external-stdlib` configuration that allows specifying a pre-compiled stdlib npm package (`@rescript/std`). More details on how to use that feature can be found in our [External Stdlib](/docs/manual/latest/build-external-stdlib) documentation.
 
 ### Less Bundle Bloat when Adding ReScript 
 

compilers/package-lock.json

@@ -5,6 +5,7 @@
   "main": "index.js",
   "license": "MIT",
   "dependencies": {
+    "rescript-902": "npm:[email protected]",
     "rescript-820": "npm:[email protected]"
   }
 }

compilers/package.json

@@ -3,7 +3,7 @@
     "username": "hongbo",
     "fullname": "Hongbo Zhang",
     "role": "Compiler & Build System",
-    "img_url": "https://pbs.twimg.com/profile_images/3157941111/cf58e90adce60b796f589b2ae5a0394a_400x400.jpeg",
+    "img_url": "https://pbs.twimg.com/profile_images/1369548222314598400/E2y46vrB_400x400.jpg",
     "twitter": "bobzhang1988"
   },
   {

data/blog_authors.json

@@ -154,8 +154,7 @@
 
                         "type": {
                             "enum": [
-                                "dev",
-                                "lib"
+                                "dev"
                             ]
                         },
                         "files": {
@@ -481,24 +480,17 @@
             "type": "boolean",
             "description": "(Experimental) whether to use the OCaml standard library. Default: true"
         },
+        "external-stdlib" : {
+            "type" : "string",
+            "description": "Use the external stdlib library instead of the one shipped with the compiler package"
+        },
         "bs-external-includes": {
             "type": "array",
             "items": {
                 "type": "string"
             },
             "description": "(Not needed usually) external include directories, which will be applied `-I` to all compilation units"
         },
-        "refmt": {
-            "$ref": "#/definitions/refmt-specs",
-            "description": "Reason syntax configuration"
-        },
-        "refmt-flags": {
-            "type": "array",
-            "items": {
-                "type": "string"
-            },
-            "description": "(Not needed usually) arguments to pass to `refmt` above. Default: `[\"--print\", \"binary\"]`."
-        },
         "suffix" : {
             "$ref" : "#/definitions/suffix-spec"
         }

data/build-schema.json

@@ -53,6 +53,8 @@
     "build-overview",
     "build-configuration",
     "build-configuration-schema",
+    "build-external-stdlib",
+    "build-pinned-dependencies",
     "interop-with-js-build-systems",
     "build-performance"
   ],

data/sidebar_manual_latest.json

@@ -47,7 +47,7 @@ A type used to describe JavaScript objects that are like an array or are iterabl
 ## from
 
 ```res sig
-let from: array_like<'a> => array<'b>
+let from: array_like<'a> => array<'a>
 ```
 
 Creates a shallow copy of an array from an array-like object. See [`Array.from`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/from) on MDN.

pages/docs/manual/latest/api/js/array-2.mdx

@@ -48,7 +48,7 @@ A type used to describe JavaScript objects that are like an array or are iterabl
 ## from
 
 ```res sig
-let from: array_like<'a> => array<'b>
+let from: array_like<'a> => array<'a>
 ```
 
 Creates a shallow copy of an array from an array-like object. See [`Array.from`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/from) on MDN.