chore: make sure that release documentation is using the new version (#60)

* Update docs.yaml

* Update release.yaml

* Update docs.yaml

* Update release.yaml

* Update qualify.yaml

Author: watermarkhu

.github/workflows/docs.yaml

@@ -19,6 +19,11 @@ on:
           Set the alias as the default version
         type: boolean
         default: true
+      ref:
+        description: >-
+          The ref to checkout and use to create docs
+        type: string
+        default: ""
       push:
         description: >-
           Push the documentation to the remote branch
@@ -36,6 +41,7 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0 # Required to push to the documentation branch
+          ref: ${{ inputs.ref }} 
 
       - name: Install the latest version of uv
         uses: astral-sh/setup-uv@v5

.github/workflows/qualify.yaml

@@ -20,7 +20,7 @@ permissions:
 
 jobs:
   docs:
-    if: github.event.pull_request.draft == false
+    if: contains(github.event.pull_request.labels.*.name, 'documentation')
     name: Test deploy documentation
     uses: ./.github/workflows/docs.yaml
     concurrency:

.github/workflows/release.yaml

@@ -13,6 +13,7 @@ jobs:
   delete-test-document:
     name: Delete test documentation
     runs-on: ubuntu-latest
+    if: contains( github.event.pull_request.labels.*.name, 'documentation')
     concurrency:
       group: gh-pages
       cancel-in-progress: false
@@ -128,10 +129,12 @@ jobs:
   mkdocs:
     name: Deploy documentation
     needs: [publish, delete-test-document]
+    if: ${{ always() && !failure() && !cancelled() }}
     uses: ./.github/workflows/docs.yaml
     secrets: inherit
     with:
       version: ${{ needs.publish.outputs.tag }}
       alias: latest
       set-default: true
+      ref: ${{ needs.publish.outputs.tag }}
       push: true