Add publish input to _docs.yml

Author: dan-fernandes

.github/workflows/_docs.yml

@@ -1,5 +1,10 @@
 on:
   workflow_call:
+    inputs:
+      publish:
+        type: boolean
+        description: If true, publishes docs to gh-pages
+
 
 jobs:
   build:
@@ -44,7 +49,7 @@ jobs:
         run: python .github/pages/make_switcher.py --add $DOCS_VERSION ${{ github.repository }} .github/pages/switcher.json
 
       - name: Publish Docs to gh-pages
-        if: needs.test.result && (github.ref_type == 'tag' || github.ref_name == 'main')
+        if: inputs.publish && (github.ref_type == 'tag' || github.ref_name == 'main')
         # We pin to the SHA, not the tag, for security reasons.
         # https://docs.github.com/en/actions/learn-github-actions/security-hardening-for-github-actions#using-third-party-actions
         uses: peaceiris/actions-gh-pages@4f9cc6602d3f66b9c108549d475ec49e8ef4d45e # v4.0.0

.github/workflows/ci.yml

@@ -29,6 +29,8 @@ jobs:
     needs: [check, test]
     if: needs.check.outputs.branch-pr == ''
     uses: ./.github/workflows/_docs.yml
+    with:
+      publish: ${{needs.test.result == 'success'}}
     permissions:
       contents: write
 

template/{% if git_platform=="github.com" %}.github{% endif %}/workflows/ci.yml.jinja

@@ -46,6 +46,9 @@ jobs:
     needs: [check, test]
     if: needs.check.outputs.branch-pr == ''
     uses: ./.github/workflows/_docs.yml
+    with:
+      publish: ${{needs.test.result == 'success'}}
+
 {% endif %}
   dist:
     needs: check