Fix build-sphinx-docs workflow

Author: yaswant

.github/workflows/build-sphinx-docs.yaml

@@ -10,10 +10,10 @@ on:
   workflow_call:
     inputs:
       docs-directory:
-        description: 'Directory containing the documentation to build'
+        description: 'Directory containing the documentation source to build'
         required: false
         type: string
-        default: './documentation'
+        default: 'documentation'
       requirements:
         description: 'Path to the requirements file to install dependencies from'
         required: true
@@ -28,7 +28,7 @@ on:
         description: 'Directory to output the html documentation to'
         required: false
         type: string
-        default: '${{inputs.docs-directory}}/build'
+        default: 'build'
       runner:
         description: 'The runner to use for the job'
         required: false
@@ -44,6 +44,7 @@ jobs:
   build-sphinx-docs:
     name: Build Sphinx Docs
     runs-on: ${{ inputs.runner }}
+    timeout-minutes: ${{ inputs.timeout }}
     env:
       DOCS_DIR: ${{ inputs.docs-directory }}
       REQS_FILE: ${{ inputs.requirements }}
@@ -57,22 +58,17 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: '3.12'
-
-      - name: Cache pip packages
-        uses: actions/cache@v4
-        with:
-          path: ~/.cache/pip
-          key: ${{ runner.os }}-pip-${{ hashFiles(env.REQS_FILE) }}
-          restore-keys: ${{ runner.os }}-pip-
-
-      - name: Minimize pip cache
-        run: python3 -m pip cache purge || true
+          cache: 'pip'
+          cache-dependency-path: ${{ inputs.requirements }}
 
       - name: Install dependencies
         run: |
           python3 -m pip install --upgrade pip
           python3 -m pip install -r "$REQS_FILE"
 
+      - name: Minimize pip cache
+        run: python3 -m pip cache remove '*' || true
+
       - name: Lint Sphinx docs
         working-directory: ${{ env.DOCS_DIR }}
         run: sphinx-lint .
@@ -82,7 +78,6 @@ jobs:
         run: |
           make html SPHINXOPTS="$SPHINX_OPTS" BUILDDIR="$BUILD_DIR"
 
-
       - name: Upload artifact to GitHub Pages
         if: ${{ (github.event_name == 'push' || github.event_name == 'merge_group') && github.ref_name == 'main'}}
         uses: actions/upload-pages-artifact@v4