Build schema

Author: chenglou

bsconfig.json

@@ -1,7 +1,10 @@
 {
+  "$schema": "https://raw.githubusercontent.com/rescript-lang/rescript-compiler/master/docs/docson/build-schema.json",
   "name": "rescript-lang.org",
   "namespace": false,
-  "reason": { "react-jsx": 3 },
+  "reason": {
+    "react-jsx": 3
+  },
   "refmt": 3,
   "bs-dependencies": [
     "reason-react",
@@ -11,12 +14,28 @@
   ],
   "ppx-flags": [],
   "sources": [
-    { "dir": "common" },
-    { "dir": "bindings" },
-    { "dir": "pages", "subdirs": true },
-    { "dir": "re_pages", "subdirs": true },
-    { "dir": "scripts", "subdirs": true },
-    { "dir": "components", "subdirs": true },
+    {
+      "dir": "common"
+    },
+    {
+      "dir": "bindings"
+    },
+    {
+      "dir": "pages",
+      "subdirs": true
+    },
+    {
+      "dir": "re_pages",
+      "subdirs": true
+    },
+    {
+      "dir": "scripts",
+      "subdirs": true
+    },
+    {
+      "dir": "components",
+      "subdirs": true
+    },
     "layouts"
   ],
   "package-specs": {
@@ -27,7 +46,11 @@
     "error": "+8"
   },
   "suffix": ".bs.js",
-  "bsc-flags": ["-bs-no-version-header", "-bs-super-errors", "-bs-g"],
+  "bsc-flags": [
+    "-bs-no-version-header",
+    "-bs-super-errors",
+    "-bs-g"
+  ],
   "gentypeconfig": {
     "language": "untyped",
     "shims": [],

pages/docs/manual/latest/build-configuration.mdx

@@ -8,7 +8,15 @@ canonical: "/docs/manual/latest/build-configuration"
 
 `bsconfig.json` is the single, mandatory build meta file needed for bsb.
 
-**The complete configuration schema is [here](https://bucklescript.github.io/bucklescript/docson/#build-schema.json)**. We'll _non-exhaustively_ highlight the important parts in prose here.
+**The complete configuration schema is [here](https://raw.githubusercontent.com/rescript-lang/rescript-compiler/master/docs/docson/build-schema.json)**. We'll _non-exhaustively_ highlight the important parts in prose below.
+
+## Tips & Tricks
+
+If you're using an editor like VSCode, put the following code as your first field in `bsconfig.json` to get schema autocompletion!
+
+```json
+"$schema": "https://raw.githubusercontent.com/rescript-lang/rescript-compiler/master/docs/docson/build-schema.json"
+```
 
 ## name, namespace