convert to mkdocs

Author: tomvanmele

.github/workflows/docs.yml

@@ -1,20 +1,29 @@
 name: docs
-
 on:
   push:
     branches:
       - main
-    tags:
-      - "v*"
-  pull_request:
-    branches:
-      - main
-
+permissions:
+  contents: write
 jobs:
-  docs:
+  deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: compas-dev/compas-actions.docs@v4
+      - uses: actions/checkout@v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@v4
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          doc_url: https://compas.dev/compas_notebook/
+          key: mkdocs-material-${{ env.cache_id }}
+          path: ~/.cache
+          restore-keys: |
+            mkdocs-material-
+      - run: pip install .[dev,docs]
+      - run: pip install mkdocs-material
+      - run: mkdocs gh-deploy --force

docs/_images/compas_notebook.png

@@ -0,0 +1 @@
+--8<-- "CHANGELOG.md"