Adds script to verify sidebars navigation

.github/workflows/microsite-build-check.yml

@@ -36,6 +36,10 @@ jobs:
         run: yarn install --frozen-lockfile
         working-directory: microsite
 
+      - name: verify sidebars
+        run: yarn verify:sidebars
+        working-directory: microsite        
+
       - name: prettier
         run: yarn prettier:check
         working-directory: microsite

microsite/package.json

@@ -11,7 +11,8 @@
     "publish-gh-pages": "docusaurus-publish",
     "write-translations": "docusaurus-write-translations",
     "version": "docusaurus-version",
-    "rename-version": "docusaurus-rename-version"
+    "rename-version": "docusaurus-rename-version",
+    "verify:sidebars": "node ./scripts/verify-sidebars"
   },
   "devDependencies": {
     "@spotify/prettier-config": "^9.0.0",

microsite/scripts/verify-sidebars.js

@@ -0,0 +1,62 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * This script relies on docusaurus internals. It can be replaced in case
+ * docusaurus adds proper validation of the sidebar items.
+ */
+
+require('@babel/polyfill');
+require('@babel/register')({
+  babelrc: false,
+  only: [`${__dirname}/..`, `${process.cwd()}/core`],
+  plugins: [
+    require('docusaurus/lib/server/translate-plugin.js'),
+    require('@babel/plugin-proposal-class-properties').default,
+    require('@babel/plugin-proposal-object-rest-spread').default,
+  ],
+  presets: [
+    require('@babel/preset-react').default,
+    require('@babel/preset-env').default,
+  ],
+});
+
+const readMetadata = require('docusaurus/lib/server/readMetadata.js');
+readMetadata.generateMetadataDocs();
+const metadata = require('docusaurus/lib/core/metadata.js');
+
+const errors = [];
+const ids = Object.keys(metadata);
+for (let id of ids) {
+  const { next, previous } = metadata[id];
+
+  if (next && !ids.includes(next)) {
+    errors.push(`Next ${next} does not exists in ${id}.`);
+  }
+
+  if (previous && !ids.includes(previous)) {
+    errors.push(`Previous ${previous} does not exists in ${id}.`);
+  }
+}
+
+if (errors.length) {
+  for (let error of errors) {
+    console.log(`❌ ${error}`);
+  }
+  process.exit(1);
+}
+
+console.log('✅ All sidebar links are correct.');