V12 docs

Author: fhammerschmidt

.env

@@ -0,0 +1,2 @@
+VERSION_LATEST="v11.0.0"
+VERSION_NEXT="v12.0.0"

data/sidebar_gentype_latest.json

@@ -0,0 +1,77 @@
+{
+  "Overview": [
+    "introduction",
+    "installation",
+    "migrate-to-v11",
+    "editor-plugins",
+    "try"
+  ],
+  "Language Features": [
+    "overview",
+    "let-binding",
+    "type",
+    "primitive-types",
+    "tuple",
+    "record",
+    "object",
+    "variant",
+    "polymorphic-variant",
+    "null-undefined-option",
+    "array-and-list",
+    "function",
+    "control-flow",
+    "pipe",
+    "pattern-matching-destructuring",
+    "mutation",
+    "jsx",
+    "exception",
+    "lazy-values",
+    "promise",
+    "async-await",
+    "tagged-templates",
+    "module",
+    "import-export",
+    "attribute",
+    "reserved-keywords",
+    "equality-comparison"
+  ],
+  "Advanced Features": [
+    "extensible-variant",
+    "scoped-polymorphic-types"
+  ],
+  "JavaScript Interop": [
+    "interop-cheatsheet",
+    "embed-raw-javascript",
+    "shared-data-types",
+    "external",
+    "bind-to-js-object",
+    "bind-to-js-function",
+    "import-from-export-to-js",
+    "bind-to-global-js-values",
+    "json",
+    "inlining-constants",
+    "use-illegal-identifier-names",
+    "generate-converters-accessors",
+    "browser-support-polyfills",
+    "libraries",
+    "typescript-integration"
+  ],
+  "Build System": [
+    "build-overview",
+    "build-configuration",
+    "build-configuration-schema",
+    "build-external-stdlib",
+    "build-pinned-dependencies",
+    "interop-with-js-build-systems",
+    "build-performance",
+    "warning-numbers"
+  ],
+  "Guides": [
+    "converting-from-js"
+  ],
+  "Extra": [
+    "newcomer-examples",
+    "project-structure",
+    "faq"
+  ]
+}

data/sidebar_manual_latest.json renamed to data/sidebar_manual_v1100.json

@@ -1,3 +1,4 @@
+// @ts-check
 import fs from "fs";
 import webpack from "webpack";
 import rehypeSlug from "rehype-slug";
@@ -7,17 +8,19 @@ import remarkFrontmatter from "remark-frontmatter";
 import remarkMdxFrontmatter from "remark-mdx-frontmatter";
 import { createLoader } from "simple-functional-loader";
 
-const bsconfig = JSON.parse(fs.readFileSync("./rescript.json"));
+const bsconfig = JSON.parse(fs.readFileSync("./rescript.json").toString());
 
 const { ProvidePlugin } = webpack;
 
 const transpileModules = ["rescript"].concat(bsconfig["bs-dependencies"]);
 
 const config = {
-  output: process.env.BUILD_STATIC === 'true' ? 'export' : undefined,
+  output: process.env.BUILD_STATIC === "true" ? "export" : undefined,
   pageExtensions: ["jsx", "js", "bs.js", "mdx", "mjs"],
   env: {
     ENV: process.env.NODE_ENV,
+    VERSION_LATEST: process.env.VERSION_LATEST,
+    VERSION_NEXT: process.env.VERSION_NEXT,
   },
   swcMinify: false,
   webpack: (config, options) => {
@@ -81,6 +84,20 @@ const config = {
     config.plugins.push(new ProvidePlugin({ React: "react" }));
     return config;
   },
+  async rewrites() {
+    return {
+      beforeFiles: [
+        {
+          source: "/docs/manual/latest/:slug",
+          destination: `/docs/manual/${process.env.VERSION_LATEST}/:slug`,
+        },
+        {
+          source: "/docs/manual/next/:slug",
+          destination: `/docs/manual/${process.env.VERSION_NEXT}/:slug`,
+        },
+      ],
+    };
+  },
   async redirects() {
     return [
       {

data/sidebar_manual_v1200.json

@@ -57,7 +57,7 @@
     "unified": "^8.4.0"
   },
   "scripts": {
-    "dev": "next",
+    "dev": "NODE_OPTIONS='--inspect' next dev",
     "build": "rescript && npm run update-index && next build",
     "test": "node scripts/test-examples.mjs && node scripts/test-hrefs.mjs",
     "reanalyze": "reanalyze -all-cmt .",

next.config.mjs

@@ -1,6 +1,6 @@
 import {
   getStaticPathsByVersion,
-  getStaticPropsByVersion
+  getStaticPropsByVersion,
 } from "src/ApiDocs.mjs";
 
 import APIDocs from "src/ApiDocs.mjs";

package.json

@@ -0,0 +1,18 @@
+import {
+  getStaticPathsByVersion,
+  getStaticPropsByVersion,
+} from "src/ApiDocs.mjs";
+
+import APIDocs from "src/ApiDocs.mjs";
+
+export async function getStaticProps(ctx) {
+  return await getStaticPropsByVersion({ ...ctx, version: "latest" });
+}
+
+export async function getStaticPaths(ctx) {
+  return await getStaticPathsByVersion("latest");
+}
+
+export default function Comp(props) {
+  return <APIDocs {...props} />;
+}