fix: pin mkdocs<2.0 and mkdocs-material<10, add NO_MKDOCS_2_WARNING to all CI doc steps

Author: Acuspeedster

.github/workflows/docs-update.yml

@@ -86,6 +86,8 @@ jobs:
         ID: ${{ steps.get-user-id.outputs.user-id }}
     - name: Create release
       shell: bash
+      env:
+        NO_MKDOCS_2_WARNING: '1'
       run: |
         mike deploy --push ${{ needs.mike-version.outputs.mver }}
     - name: Ensure latest is latest

.github/workflows/python-push.yml

@@ -101,6 +101,8 @@ jobs:
         make docs-ubuntu-deps
     - name: Validate website content (mkdocs)
       if: steps.core-version.outputs.core == 'true'
+      env:
+        NO_MKDOCS_2_WARNING: '1'
       run: |
         make docs-validate
     - name: Pytest Fast

.github/workflows/python-test.yml

@@ -67,9 +67,13 @@ jobs:
       run: |
         make docs-ubuntu-deps
     - name: Validate website content (mkdocs)
+      env:
+        NO_MKDOCS_2_WARNING: '1'
       run: |
         make docs-validate
     - name: Check if dirty (mkdocs)
+      env:
+        NO_MKDOCS_2_WARNING: '1'
       run: |
         make check-for-changes
 

pyproject.toml

@@ -64,11 +64,11 @@ typing = [
 # Documentation website
 docs = [
     "mike",
-    "mkdocs>=1.6.0",
+    "mkdocs>=1.6.0,<2.0.0",
     "mkdocs-awesome-pages-plugin",
     "mkdocstrings[python]>=0.25.2",
     "mkdocs-htmlproofer-plugin",
-    "mkdocs-material",
+    "mkdocs-material>=9.0.0,<10.0.0",
     "markdown-include",
     "mkdocs-minify-plugin",
     "mkdocs-git-revision-date-localized-plugin",