chore: Refactor mdBook workflow to improve efficiency

Author: mattheworris

.github/workflows/deploy-gh-pages.yaml

@@ -15,43 +15,46 @@ permissions:
   id-token: write
 
 jobs:
-  build:
+  # Build mdbook
+  build-mdbook: 
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        service:
-          - account
-          - content-watcher
-          - content-publishing
-          - graph
-
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
       - name: Set up mdBook 📚
-        if: matrix.service == 'account' # Only upload mdbook once
         uses: ./.github/workflows/common/set-up-mdbook
         with:
           token: ${{secrets.GITHUB_TOKEN}}
       - name: Setup Pages
-        if: matrix.service == 'account' # Only setup Pages once
         id: pages
         uses: actions/configure-pages@v4
 
       - name: Build with mdBook
-        if: matrix.service == 'account' # Only build mdbook once
         working-directory: docs
         run: mdbook build && ls book
 
       # Upload the mdBook output to GitHub Pages
       - name: Upload mdbook to GitHub Pages
-        if: matrix.service == 'account' # Only upload mdbook once
         uses: actions/upload-artifact@v4
         with:
           name: mdbook
           path: ./docs
 
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        service:
+          - account
+          - content-watcher
+          - content-publishing
+          - graph
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
       # Publish OpenAPI specs for each microservice
       - name: Build and Publish OpenAPI spec for ${{ matrix.service }}
         uses: ./.github/workflows/common/openapi-build
@@ -68,7 +71,7 @@ jobs:
   deploy:
     name: Deploy mdbook and OpenAPI microservices to GitHub Pages
     runs-on: ubuntu-latest
-    needs: build
+    needs: [build, build-mdbook]
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}