Only run the Docker build when relevant changes are made

The Docker build is comparatively slow (1-2 minutes) and mostly
redundant given that the majority of PRs change docs content rather
than configuration or build system.

Author: PeterJCLaw

.github/workflows/validate.yml

@@ -28,7 +28,31 @@ jobs:
     - name: Build & Validate
       run: rake validate
 
+  changes:
+    runs-on: ubuntu-latest
+    if: github.ref != 'refs/heads/master'
+    permissions:
+      pull-requests: read
+    outputs:
+      docker: ${{ steps.filter.outputs.docker }}
+    steps:
+    - uses: dorny/paths-filter@v2
+      id: filter
+      with:
+        filters: |
+          docker:
+            - '_config.yml'
+            - '.dockerignore'
+            - '.github/workflows/validate.yml'
+            - '*docker*'
+            - 'Dockerfile'
+            - 'Gemfile*'
+            - 'package*.json'
+            - 'Rakefile'
+
   docker:
+    needs: changes
+    if: needs.changes.outputs.docker == 'true' || github.ref == 'refs/heads/master'
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v2