Merge branch 'main' into sitemap

.gitattributes

@@ -3,6 +3,7 @@
 /.github export-ignore
 /dev export-ignore
 /docs export-ignore
+/docs_includes export-ignore
 /tests export-ignore
 
 /.all-contributorsrc export-ignore

.github/workflows/docs.yml

@@ -0,0 +1,39 @@
+name: MkDocs
+
+on:
+  workflow_call:
+  # Allow manually triggering the workflow.
+  workflow_dispatch:
+
+  push:
+    branches:
+      - main
+      - documentation
+    paths:
+      - 'docs/**.md'
+      - 'docs/**.html'
+      - 'docs/**.yml'
+      - 'docs_includes/**.md'
+      - 'mkdocs.yml'
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v4
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+
+      - uses: actions/cache@v3
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      - run: pip3 install mkdocs mkdocs-material mkdocs-minify-plugin mkdocs-redirects
+
+      - name: Publish docs
+        run: mkdocs gh-deploy --force

.github/workflows/phpstan.yml

@@ -40,7 +40,7 @@ jobs:
         uses: actions/cache/restore@v4
         with:
           path: .phpstan.cache
-          key: "phpstan-result-cache-${{ github.run_id }}"
+          key: phpstan-result-cache-${{ matrix.php-versions }}-${{ github.run_id }}
           restore-keys: |
             phpstan-result-cache-
 
@@ -52,4 +52,4 @@ jobs:
         if: always()
         with:
           path: .phpstan.cache
-          key: "phpstan-result-cache-${{ github.run_id }}"
+          key: phpstan-result-cache-${{ matrix.php-versions }}-${{ github.run_id }}

.gitignore

@@ -91,6 +91,9 @@ phpunit.xml
 /shell/update-copyright.php
 /shell/translations.php
 
+# generated by mkdocs serve
+/site
+
 # DDEV
 .ddev/config.yaml
 .ddev/.sampleData