Split projects, version docs, prep for 1.19 (#63)

* Refactor for multiple does plugin instances

* fix issue from merge

* split dev and admin docs

* remove getting help sidebar links

* wiki -> docs

* common -> misc

* enable debug plugin

* relocate misc category to misc base path

* add current required redirects

currently in cloudflare pages/netlify format. may change depending on
eventual deployment decision

* Add category indexes to landing pages and resolve naming issues

* swizzle DropdownNavbarItem

* mark desktop dropdown as active when has active children

* better implement same idea

* only show dropdown when page not active

* cache assets

* update dependencies, node_modules

* greatly improve development scripts

* clean up custom tags plugin, partially prepare for cloudflare pages/netlify

* prepare for versioning

* initial versioning, split 1.18

* fix build

* fix nondeterministic resolution by fully qualifying plugin name

* clean up versioned directory structure

* relock

* move versioned content to docs folder

* disable automatic deployment

* remove redundancy in config docs naming

* configure vercel

Author: e-im

.github/workflows/build-artifact.yaml

@@ -15,6 +15,4 @@ yarn-error.log*
 !.yarn/releases
 !.yarn/sdks
 !.yarn/versions
-/config/*.js
-/*.js
-/*.js.map
+/.meta

.github/workflows/build-pr.yaml

@@ -7,3 +7,4 @@
 /*.js
 /*.js.map
 /config/*.js
+/.meta

.github/workflows/build.yaml

@@ -0,0 +1,57 @@
+diff --git a/lib/constants.js b/lib/constants.js
+index f91e43f00e1f9160afa6a34ed1df71c90fe45a28..db04a015ea2d4474339b1d02f6fbec75ba14c894 100644
+--- a/lib/constants.js
++++ b/lib/constants.js
+@@ -10,8 +10,8 @@ exports.VERSIONS_JSON_FILE = exports.VERSIONED_SIDEBARS_DIR = exports.VERSIONED_
+ /** The name of the version that's actively worked on (e.g. `website/docs`) */
+ exports.CURRENT_VERSION_NAME = 'current';
+ /** All doc versions are stored here by version names */
+-exports.VERSIONED_DOCS_DIR = 'versioned_docs';
++exports.VERSIONED_DOCS_DIR = 'content';
+ /** All doc versioned sidebars are stored here by version names */
+-exports.VERSIONED_SIDEBARS_DIR = 'versioned_sidebars';
++exports.VERSIONED_SIDEBARS_DIR = 'sidebars';
+ /** The version names. Should 1-1 map to the content of versioned docs dir. */
+-exports.VERSIONS_JSON_FILE = 'versions.json';
++exports.VERSIONED_BASE_DIR = 'docs/versioned';
+diff --git a/lib/versions/files.js b/lib/versions/files.js
+index 5a3efcb0b3dec47120fe32b8824e0c4ca7987df8..5295a02a6fe5829d7621a37a14d456947a75c6de 100644
+--- a/lib/versions/files.js
++++ b/lib/versions/files.js
+@@ -13,20 +13,14 @@ const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+ const utils_1 = require("@docusaurus/utils");
+ const constants_1 = require("../constants");
+ const validation_1 = require("./validation");
+-/** Add a prefix like `community_version-1.0.0`. No-op for default instance. */
+-function addPluginIdPrefix(fileOrDir, pluginId) {
+-    return pluginId === utils_1.DEFAULT_PLUGIN_ID
+-        ? fileOrDir
+-        : `${pluginId}_${fileOrDir}`;
+-}
+-/** `[siteDir]/community_versioned_docs/version-1.0.0` */
++/** `[siteDir]/docs/versioned/paper/content/1.0.0` */
+ function getVersionDocsDirPath(siteDir, pluginId, versionName) {
+-    return path_1.default.join(siteDir, addPluginIdPrefix(constants_1.VERSIONED_DOCS_DIR, pluginId), `version-${versionName}`);
++    return path_1.default.join(siteDir, constants_1.VERSIONED_BASE_DIR, pluginId, constants_1.VERSIONED_DOCS_DIR, versionName);
+ }
+ exports.getVersionDocsDirPath = getVersionDocsDirPath;
+-/** `[siteDir]/community_versioned_sidebars/version-1.0.0-sidebars.json` */
++/** `[siteDir]/docs/versioned/paper/sidebars/1.0.0.json` */
+ function getVersionSidebarsPath(siteDir, pluginId, versionName) {
+-    return path_1.default.join(siteDir, addPluginIdPrefix(constants_1.VERSIONED_SIDEBARS_DIR, pluginId), `version-${versionName}-sidebars.json`);
++    return path_1.default.join(siteDir, constants_1.VERSIONED_BASE_DIR, pluginId, constants_1.VERSIONED_SIDEBARS_DIR, `${versionName}.json`);
+ }
+ exports.getVersionSidebarsPath = getVersionSidebarsPath;
+ function getDocsDirPathLocalized({ siteDir, locale, pluginId, versionName, }) {
+@@ -43,9 +37,9 @@ function getDocsDirPathLocalized({ siteDir, locale, pluginId, versionName, }) {
+     });
+ }
+ exports.getDocsDirPathLocalized = getDocsDirPathLocalized;
+-/** `community` => `[siteDir]/community_versions.json` */
++/** `community` => `[siteDir]/docs/versioned/paper.json` */
+ function getVersionsFilePath(siteDir, pluginId) {
+-    return path_1.default.join(siteDir, addPluginIdPrefix(constants_1.VERSIONS_JSON_FILE, pluginId));
++    return path_1.default.join(siteDir, constants_1.VERSIONED_BASE_DIR, `${pluginId}.json`);
+ }
+ exports.getVersionsFilePath = getVersionsFilePath;
+ /**

.github/workflows/preview.yaml

@@ -1,9 +1,16 @@
-nodeLinker: pnp
+nodeLinker: pnpm
 
 plugins:
   - path: .yarn/plugins/@yarnpkg/plugin-interactive-tools.cjs
     spec: "@yarnpkg/plugin-interactive-tools"
   - path: .yarn/plugins/@yarnpkg/plugin-typescript.cjs
     spec: "@yarnpkg/plugin-typescript"
 
+packageExtensions:
+  esbuild-loader@*:
+    dependencies:
+      webpack: ^5.72.1
+
+defaultSemverRangePrefix: ""
+
 yarnPath: .yarn/releases/yarn-3.2.0.cjs

.gitignore

@@ -29,7 +29,7 @@ $ yarn
 3. Start the development server
 
 ```bash
-$ yarn start
+$ yarn dev
 ```
 
 This will start a local development server and open a browser window. The majority of changes will