feat(v2): docs versioning ❄️🔥 (#1983)

* wip: versioning

* wip again

* nits lint

* refactor metadata code so that we can have inobject properties optimization, fix typing

* remove buggy permalink code

* modify versioned docs fixture such that foo/baz only exists in v1.0.0

* refactor metadata.ts so that there is less transformon object

* more refactoring

* reduce test fixtures, refactoring

* refactoring readability

* finish metadata part

* refactor with readdir

* first pass of implementation

* fix mdx laoder

* split generated routes by version for performance & smaller bundle

* test data for demo

* refactor with set

* more tests

* typo

* fix typo

* better temporary ui

* stronger typing & docsVersion command

* add 100% test coverage for docsVersion command

* more test and delete manual docs cut

* cut 2.0.0-alpha.35 docs

* cut alpha.36 instead

* copyright

* delete versioned docs

* stronger test on metadata

* update typo

packages/docusaurus-plugin-content-docs/package.json

@@ -12,6 +12,7 @@
   "license": "MIT",
   "devDependencies": {
     "@docusaurus/types": "^2.0.0-alpha.36",
+    "commander": "^4.0.1",
     "picomatch": "^2.1.0"
   },
   "dependencies": {
@@ -22,6 +23,7 @@
     "globby": "^10.0.1",
     "import-fresh": "^3.1.0",
     "loader-utils": "^1.2.3",
+    "lodash": "^4.17.15",
     "shelljs": "^0.8.3"
   },
   "peerDependencies": {

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/simple-site/docs/lorem.md

@@ -1,5 +1,6 @@
 ---
 custom_edit_url: https://github.com/customUrl/docs/lorem.md
+unrelated_frontmatter: won't be part of metadata
 ---
 
 Lorem ipsum.

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/simple-site/docusaurus.config.js

@@ -11,6 +11,4 @@ module.exports = {
   url: 'https://your-docusaurus-test-site.com',
   baseUrl: '/',
   favicon: 'img/favicon.ico',
-  organizationName: 'facebook', // Usually your GitHub org/user name.
-  projectName: 'docusaurus', // Usually your repo name.
 };

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/docs/foo/bar.md

@@ -0,0 +1 @@
+This is `next` version of bar.

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/docs/hello.md

@@ -0,0 +1 @@
+Hello `next` !

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/docusaurus.config.js

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2017-present, Facebook, Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+module.exports = {
+  title: 'Versioned Site',
+  tagline: 'The tagline of my site',
+  url: 'https://your-docusaurus-test-site.com',
+  baseUrl: '/',
+  favicon: 'img/favicon.ico',
+};

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/sidebars.json

@@ -0,0 +1,10 @@
+{
+  "docs": {
+    "Test": [
+      "foo/bar"
+    ],
+    "Guides": [
+      "hello"
+    ]
+  }
+}

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/versioned_docs/version-1.0.0/foo/bar.md

@@ -0,0 +1 @@
+Bar `1.0.0` !

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/versioned_docs/version-1.0.0/foo/baz.md

@@ -0,0 +1 @@
+Baz `1.0.0` ! This will be deleted in next subsequent versions.

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/versioned_docs/version-1.0.0/hello.md

@@ -0,0 +1 @@
+Hello `1.0.0` !

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/versioned_docs/version-1.0.1/foo/bar.md

@@ -0,0 +1 @@
+Bar `1.0.1` !

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/versioned_docs/version-1.0.1/hello.md

@@ -0,0 +1 @@
+Hello `1.0.1` !

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/versioned_sidebars/version-1.0.0-sidebars.json

@@ -0,0 +1,11 @@
+{
+  "version-1.0.0/docs": {
+    "Test": [
+      "version-1.0.0/foo/bar",
+      "version-1.0.0/foo/baz"
+    ],
+    "Guides": [
+      "version-1.0.0/hello"
+    ]
+  }
+}

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/versioned_sidebars/version-1.0.1-sidebars.json

@@ -0,0 +1,10 @@
+{
+  "version-1.0.1/docs": {
+    "Test": [
+      "version-1.0.1/foo/bar"
+    ],
+    "Guides": [
+      "version-1.0.1/hello"
+    ]
+  }
+}

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/versions.json

@@ -0,0 +1,4 @@
+[
+  "1.0.1",
+  "1.0.0"
+]