Limit to docs download when docs folder is present

.github/actions/mkdocs-pages/action.yaml

@@ -18,24 +18,24 @@ inputs:
     description: if to publish docs to gh-pages
     type: string
     default: ''
-  path:
-    description: relative path under $GITHUB_WORKSPACE to checkout root
+  docs_folder:
+    description: docs folder path. If empty, it checkouts all to a fresh 'docs'
     type: string
-    default: ''
+    default: docs
 
 runs:
   using: composite
   steps:
-    - if: ${{ inputs.path }}
+    - if: ${{ !inputs.docs_folder }}
       name: Checkout CI
       uses: actions/checkout@v4
       with:
         sparse-checkout: .github
     - name: Checkout root
       uses: actions/checkout@v4
       with:
-        path: ${{ inputs.path }}
-        sparse-checkout: ${{ inputs.path && '.' || '' }}
+        path: ${{ inputs.docs_folder && '' || 'docs' }}
+        sparse-checkout: ${{ inputs.docs_folder }}
     - name: Set up Python
       uses: actions/setup-python@v5
       with:

.github/workflows/compose_test.yaml

@@ -97,7 +97,7 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           DOCS_LINK_CHECK: true
           TAG: ${{ github.sha }}
-          path: docs
+          docs_folder: ''
   test:
     runs-on: ubuntu-latest
     needs:

.github/workflows/mkdocs.yaml

@@ -15,4 +15,4 @@ jobs:
         with:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           push: true
-          path: docs
+          docs_folder: ''