ci: Skip build for docs-only changes

Add paths-ignore to build-any-branch-with-all-dbs.yml so pushes and PRs
touching only src/site/**, *.adoc, or *.md files skip the full
compile/IT matrix (and thus also skip deploy-snapshot, which fires only
on a successful build workflow_run).

Add a direct push trigger on main with matching paths to
publish-docs.yml so the site is still rebuilt and deployed when
docs-only changes land on main without a build workflow run. Rewrite
the build-site job condition to use negation (event_name != 'workflow_run')
so all non-workflow_run triggers are covered without enumerating each one.
Update the upload-pages-artifact step and deploy job conditions to
explicitly allow the push event.

Author: jeffjensen

.github/workflows/build-any-branch-with-all-dbs.yml

@@ -1,6 +1,16 @@
 name: Build any branch with all databases
 
-on: [push, pull_request]
+on:
+  push:
+    paths-ignore:
+      - 'src/site/**'
+      - '**/*.adoc'
+      - '**/*.md'
+  pull_request:
+    paths-ignore:
+      - 'src/site/**'
+      - '**/*.adoc'
+      - '**/*.md'
 
 env:
   MAVEN_COMMAND: ./mvnw

.github/workflows/publish-docs.yml

@@ -2,6 +2,12 @@ name: Build and Deploy Maven Site to GitHub Pages
 
 on:
   workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - 'src/site/**'
+      - '**/*.adoc'
+      - '**/*.md'
   workflow_run:
     workflows: ["Build any branch with all databases", "Record Dependabot update in changes.xml"]
     types: [completed]
@@ -22,7 +28,7 @@ env:
 
 jobs:
   build-site:
-    if: github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success'
+    if: github.event_name != 'workflow_run' || github.event.workflow_run.conclusion == 'success'
     runs-on: ubuntu-latest
     timeout-minutes: 20
     steps:
@@ -33,14 +39,20 @@ jobs:
     - name: Generate Maven site
       run: ${{ env.MAVEN_COMMAND }} ${{ env.MAVEN_CLI_COMMON }} site -Dproject.build.outputTimestamp=$(date -u +%Y-%m-%dT%H:%M:%SZ)
     - name: Upload Pages artifact
-      if: github.event_name == 'workflow_dispatch' || github.event_name == 'workflow_run'
+      if: >-
+        github.event_name == 'workflow_dispatch' ||
+        github.event_name == 'push' ||
+        github.event_name == 'workflow_run'
       uses: actions/upload-pages-artifact@v5
       with:
         path: target/site/
 
   deploy:
     needs: build-site
-    if: github.event_name == 'workflow_dispatch' || github.event_name == 'workflow_run'
+    if: >-
+      github.event_name == 'workflow_dispatch' ||
+      github.event_name == 'push' ||
+      github.event_name == 'workflow_run'
     runs-on: ubuntu-latest
     timeout-minutes: 10
     environment: