Merge pull request #17643 from adamdmharvey/adamdmharvey/cicd-mkdocs

feat(pipeline): Add MkDocs verification & fix MkDocs nav warnings

.github/workflows/verify_microsite-noop.yml

@@ -6,7 +6,9 @@ on:
   pull_request:
     paths-ignore:
       - '.github/workflows/verify_microsite-next.yml'
+      - '.github/workflows/verify_microsite.yml'
       - 'microsite/**'
+      - 'mkdocs.yml'
       - 'docs/**'
 
 jobs:

.github/workflows/verify_microsite.yml

@@ -4,7 +4,9 @@ on:
   pull_request:
     paths:
       - '.github/workflows/verify_microsite-next.yml'
+      - '.github/workflows/verify_microsite.yml'
       - 'microsite/**'
+      - 'mkdocs.yml'
       - 'docs/**'
 
 jobs:
@@ -37,6 +39,12 @@ jobs:
       - name: build API reference
         run: yarn build:api-docs
 
+      - name: Install MkDocs dependencies
+        run: pip3 install mkdocs mkdocs-techdocs-core
+
+      - name: Build MkDocs for TechDocs
+        run: mkdocs build --strict
+
       - name: verify yarn dependency duplicates
         run: node scripts/verify-lockfile-duplicates.js
 

.github/workflows/verify_storybook.yml

@@ -49,7 +49,7 @@ jobs:
       - uses: chromaui/action@v1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
-          # projetToken intentionally shared to allow collaborators to run Chromatic on forks
+          # projectToken intentionally shared to allow collaborators to run Chromatic on forks
           # https://www.chromatic.com/docs/custom-ci-provider#run-chromatic-on-external-forks-of-open-source-projects
           projectToken: 9tzak77m9nj
           workingDir: storybook