docs: consolidated docs update (orchestrate-advanced, builder platform/OS mapping, large-projects fixes)

.github/workflows/cats.yml

@@ -10,6 +10,7 @@ jobs:
   aCatForCreatingThePullRequest:
     name: A cat for your effort!
     runs-on: ubuntu-latest
+    timeout-minutes: 5
     steps:
       - name: Action Cats
         uses: ruairidhwm/action-cats@1.0.2

.github/workflows/checks.yml

@@ -8,6 +8,7 @@ jobs:
   codeFormatting:
     name: Code formatting
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@v4
       - name: Read Node version from mise.toml
@@ -25,7 +26,7 @@ jobs:
         id: yarn-config
         run: echo "cacheFolder=$(yarn config get cacheFolder)" >> "$GITHUB_OUTPUT"
       - name: Restore yarn install cache (node_modules + cacheFolder + install-state)
-        uses: actions/cache@v4
+        uses: actions/cache/restore@v4
         with:
           path: |
             node_modules
@@ -42,10 +43,24 @@ jobs:
         run: |
           case "$(yarn --version)" in 1.*) echo 'expected up-to-date yarn version'; exit 1 ;; esac
           yarn install --immutable
+      - name: Save yarn install cache (node_modules + cacheFolder + install-state)
+        if: always()
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            node_modules
+            ${{ steps.yarn-config.outputs.cacheFolder }}
+            .yarn/install-state.gz
+          key:
+            yarn-${{ runner.os }}-node${{ steps.node.outputs.version }}-${{ hashFiles('yarn.lock')
+            }}
+        timeout-minutes: 5
+        continue-on-error: true
       - run: yarn format:check
   codeStyles:
     name: Code styles
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@v4
       - name: Read Node version from mise.toml
@@ -63,7 +78,7 @@ jobs:
         id: yarn-config
         run: echo "cacheFolder=$(yarn config get cacheFolder)" >> "$GITHUB_OUTPUT"
       - name: Restore yarn install cache (node_modules + cacheFolder + install-state)
-        uses: actions/cache@v4
+        uses: actions/cache/restore@v4
         with:
           path: |
             node_modules
@@ -80,10 +95,24 @@ jobs:
         run: |
           case "$(yarn --version)" in 1.*) echo 'expected up-to-date yarn version'; exit 1 ;; esac
           yarn install --immutable
+      - name: Save yarn install cache (node_modules + cacheFolder + install-state)
+        if: always()
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            node_modules
+            ${{ steps.yarn-config.outputs.cacheFolder }}
+            .yarn/install-state.gz
+          key:
+            yarn-${{ runner.os }}-node${{ steps.node.outputs.version }}-${{ hashFiles('yarn.lock')
+            }}
+        timeout-minutes: 5
+        continue-on-error: true
       - run: yarn lint
   types:
     name: Types check
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@v4
       - name: Read Node version from mise.toml
@@ -101,7 +130,7 @@ jobs:
         id: yarn-config
         run: echo "cacheFolder=$(yarn config get cacheFolder)" >> "$GITHUB_OUTPUT"
       - name: Restore yarn install cache (node_modules + cacheFolder + install-state)
-        uses: actions/cache@v4
+        uses: actions/cache/restore@v4
         with:
           path: |
             node_modules
@@ -118,10 +147,24 @@ jobs:
         run: |
           case "$(yarn --version)" in 1.*) echo 'expected up-to-date yarn version'; exit 1 ;; esac
           yarn install --immutable
+      - name: Save yarn install cache (node_modules + cacheFolder + install-state)
+        if: always()
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            node_modules
+            ${{ steps.yarn-config.outputs.cacheFolder }}
+            .yarn/install-state.gz
+          key:
+            yarn-${{ runner.os }}-node${{ steps.node.outputs.version }}-${{ hashFiles('yarn.lock')
+            }}
+        timeout-minutes: 5
+        continue-on-error: true
       - run: yarn typecheck
   tests:
     name: Tests
     runs-on: ubuntu-latest
+    timeout-minutes: 15
     steps:
       - uses: actions/checkout@v4
       - name: Read Node version from mise.toml
@@ -139,7 +182,7 @@ jobs:
         id: yarn-config
         run: echo "cacheFolder=$(yarn config get cacheFolder)" >> "$GITHUB_OUTPUT"
       - name: Restore yarn install cache (node_modules + cacheFolder + install-state)
-        uses: actions/cache@v4
+        uses: actions/cache/restore@v4
         with:
           path: |
             node_modules
@@ -156,13 +199,27 @@ jobs:
         run: |
           case "$(yarn --version)" in 1.*) echo 'expected up-to-date yarn version'; exit 1 ;; esac
           yarn install --immutable
+      - name: Save yarn install cache (node_modules + cacheFolder + install-state)
+        if: always()
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            node_modules
+            ${{ steps.yarn-config.outputs.cacheFolder }}
+            .yarn/install-state.gz
+          key:
+            yarn-${{ runner.os }}-node${{ steps.node.outputs.version }}-${{ hashFiles('yarn.lock')
+            }}
+        timeout-minutes: 5
+        continue-on-error: true
       - run: yarn test --coverage
       - run: bash <(curl -s https://codecov.io/bash)
         env:
           CODECOV_TOKEN: '2f2eb890-30e2-4724-83eb-7633832cf0de'
   e2e:
     name: E2E tests
     runs-on: ubuntu-latest
+    timeout-minutes: 20
     steps:
       - uses: actions/checkout@v4
       - name: Read Node version from mise.toml
@@ -180,7 +237,7 @@ jobs:
         id: yarn-config
         run: echo "cacheFolder=$(yarn config get cacheFolder)" >> "$GITHUB_OUTPUT"
       - name: Restore yarn install cache (node_modules + cacheFolder + install-state)
-        uses: actions/cache@v4
+        uses: actions/cache/restore@v4
         with:
           path: |
             node_modules
@@ -197,6 +254,19 @@ jobs:
         run: |
           case "$(yarn --version)" in 1.*) echo 'expected up-to-date yarn version'; exit 1 ;; esac
           yarn install --immutable
+      - name: Save yarn install cache (node_modules + cacheFolder + install-state)
+        if: always()
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            node_modules
+            ${{ steps.yarn-config.outputs.cacheFolder }}
+            .yarn/install-state.gz
+          key:
+            yarn-${{ runner.os }}-node${{ steps.node.outputs.version }}-${{ hashFiles('yarn.lock')
+            }}
+        timeout-minutes: 5
+        continue-on-error: true
       - run: yarn build
       - run: npx playwright install --with-deps chromium
       - run: yarn test:e2e

.github/workflows/firebase-hosting-merge.yml

@@ -9,6 +9,7 @@ name: Deploy Live
 jobs:
   build_and_deploy:
     runs-on: ubuntu-latest
+    timeout-minutes: 20
     steps:
       # Checkout
       - uses: actions/checkout@v4
@@ -29,7 +30,7 @@ jobs:
         id: yarn-config
         run: echo "cacheFolder=$(yarn config get cacheFolder)" >> "$GITHUB_OUTPUT"
       - name: Restore yarn install cache (node_modules + cacheFolder + install-state)
-        uses: actions/cache@v4
+        uses: actions/cache/restore@v4
         with:
           path: |
             node_modules
@@ -46,6 +47,19 @@ jobs:
         run: |
           case "$(yarn --version)" in 1.*) echo 'expected up-to-date yarn version'; exit 1 ;; esac
           yarn install --immutable
+      - name: Save yarn install cache (node_modules + cacheFolder + install-state)
+        if: always()
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            node_modules
+            ${{ steps.yarn-config.outputs.cacheFolder }}
+            .yarn/install-state.gz
+          key:
+            yarn-${{ runner.os }}-node${{ steps.node.outputs.version }}-${{ hashFiles('yarn.lock')
+            }}
+        timeout-minutes: 5
+        continue-on-error: true
       - name: Build website
         run: yarn build
 

.github/workflows/firebase-hosting-pull-request.yml

@@ -7,6 +7,7 @@ jobs:
   build_and_preview:
     if: '${{ github.event.pull_request.head.repo.full_name == github.repository }}'
     runs-on: ubuntu-latest
+    timeout-minutes: 20
     steps:
       # Checkout
       - uses: actions/checkout@v4
@@ -27,7 +28,7 @@ jobs:
         id: yarn-config
         run: echo "cacheFolder=$(yarn config get cacheFolder)" >> "$GITHUB_OUTPUT"
       - name: Restore yarn install cache (node_modules + cacheFolder + install-state)
-        uses: actions/cache@v4
+        uses: actions/cache/restore@v4
         with:
           path: |
             node_modules
@@ -44,6 +45,19 @@ jobs:
         run: |
           case "$(yarn --version)" in 1.*) echo 'expected up-to-date yarn version'; exit 1 ;; esac
           yarn install --immutable
+      - name: Save yarn install cache (node_modules + cacheFolder + install-state)
+        if: always()
+        uses: actions/cache/save@v4
+        with:
+          path: |
+            node_modules
+            ${{ steps.yarn-config.outputs.cacheFolder }}
+            .yarn/install-state.gz
+          key:
+            yarn-${{ runner.os }}-node${{ steps.node.outputs.version }}-${{ hashFiles('yarn.lock')
+            }}
+        timeout-minutes: 5
+        continue-on-error: true
       - name: Build website
         run: yarn build
 

.github/workflows/search-trigger.yml

@@ -5,6 +5,7 @@ jobs:
   updateSearchIndex:
     name: Update search index
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@v4
       - uses: darrenjennings/algolia-docsearch-action@da2ed379c147b356d60dbfec68bdcfacb2791a98