Consolidate the mkdocs to GitHub Pages publish workflow

* Use a shared GitHub Workflow to build the mkdocs site and
publish to GitHub Pages (when the release-docs branch is updated)

.github/workflows/publish.yaml

@@ -3,28 +3,10 @@ on:
   push:
     branches:
       - release-docs
-permissions:
-  contents: write
 jobs:
-  publish:
+  mkdocs:
-    name: publish
+    name: mkdocs
-    runs-on: ubuntu-latest
+    uses: poseidon/matchbox/.github/workflows/mkdocs-pages.yaml@main
-    steps:
+    # Add content write for GitHub Pages
-      # Checkout repo to GitHub Actions runner
+    permissions:
-      - name: Checkout
+      contents: write
-        uses: actions/checkout@v3
-
-      # Install Python
-      - name: Setup Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: 3.x
-
-      # Install PyPI packages
-      - name: Dependencies
-        run: pip install -r requirements.txt
-
-      # Push to GitHub Pages
-      - name: Push Docs
-        run: |
-          mkdocs gh-deploy --force