From 8ea1d48473c3437feb0d64e5097dd3962561ade3 Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 12:53:34 +0200
Subject: [PATCH 01/13] Docusaurus API reference sync

---
 .github/workflows/CI_docusaurus_sync.yml | 109 +++++++++++++++++++++++
 1 file changed, 109 insertions(+)
 create mode 100644 .github/workflows/CI_docusaurus_sync.yml

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
new file mode 100644
index 0000000000..8ca4549f8f
--- /dev/null
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -0,0 +1,109 @@
+name: Core / Sync API reference with Docusaurus
+
+on:
+  # for testing purposes
+  pull_request:
+  push:
+    tags:
+      - "**-v[0-9].[0-9]+.[0-9]+"
+
+  workflow_dispatch: # Activate this workflow manually
+    inputs:
+      tag:
+        description: "Tag with this format: integrations/<INTEGRATION_FOLDER_NAME>-v1.0.0"
+        required: true
+        type: string
+        default: integrations/<INTEGRATION_FOLDER_NAME>-v1.0.0
+
+env:
+  # TAG: ${{ inputs.tag || github.ref_name}}
+  # for testing purposes
+  TAG: integrations/qdrant-v1.0.0
+
+jobs:
+  generate-docs:
+    runs-on: ubuntu-latest
+    outputs:
+      artifact_name: ${{ steps.pathfinder.outputs.docusaurus_fname }}
+
+    steps:
+      - name: Checkout this repo
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -U haystack-pydoc-tools hatch
+
+      - name: Get project folder
+        id: pathfinder
+        shell: python
+        run: |
+          import os
+          project_path = os.environ["TAG"].rsplit("-", maxsplit=1)[0]
+          docusaurus_fname = project_path.replace("/integrations", "")
+          with open(os.environ['GITHUB_OUTPUT'], 'a') as f:
+            print(f'project_path={project_path}', file=f)
+            print(f'docusaurus_fname={docusaurus_fname}', file=f)
+
+      - name: Generate docs
+        working-directory: ${{ steps.pathfinder.outputs.project_path }}
+
+        run: hatch run docs
+
+      - name: Upload docs artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ steps.pathfinder.outputs.docusaurus_fname }}
+          path: ${{ steps.pathfinder.outputs.project_path }}/${{ steps.pathfinder.outputs.docusaurus_fname }}.md
+          if-no-files-found: error
+          retention-days: 1
+          overwrite: true
+
+
+  sync-docs:
+    runs-on: ubuntu-latest
+    needs: generate-docs
+    
+    steps:
+      - name: Checkout Haystack repo
+        uses: actions/checkout@v5
+        with:
+          repository: deepset-ai/haystack
+          ref: main
+          token: ${{ secrets.HAYSTACK_BOT_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.10"          
+
+      - name: Download docs artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: ${{ needs.generate-docs.outputs.artifact_name }}
+
+      - name: Sync docs
+        shell: python
+        run: |
+          import os
+          import shutil
+          # Copy the artifact markdown to docs-website/reference/integrations_api
+          artifact_fname = os.environ['ARTIFACT_NAME']+'.md'
+          haystack_docs_path = "docs-website/reference/integrations_api/"
+          shutil.copy(artifact_fname, haystack_docs_path)
+
+          # loop over docs-website/reference_versioned_docs subfolders and copy the artifact markdown to the corresponding folder
+          for folder in os.listdir("docs-website/reference_versioned_docs"):
+            shutil.copy(artifact_fname, "docs-website/reference_versioned_docs/" + folder + "/" + artifact_fname)
+
+          # remove the artifact markdown
+          os.remove(artifact_fname)
+
+      - name: Print git status
+        run: git status
\ No newline at end of file

From f645fbf737f14fc1c732b397488fafec983bc497 Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 12:57:22 +0200
Subject: [PATCH 02/13] retry

---
 .github/workflows/CI_docusaurus_sync.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index 8ca4549f8f..d410149acf 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -46,7 +46,7 @@ jobs:
         run: |
           import os
           project_path = os.environ["TAG"].rsplit("-", maxsplit=1)[0]
-          docusaurus_fname = project_path.replace("/integrations", "")
+          docusaurus_fname = project_path.split("/")[-1]
           with open(os.environ['GITHUB_OUTPUT'], 'a') as f:
             print(f'project_path={project_path}', file=f)
             print(f'docusaurus_fname={docusaurus_fname}', file=f)

From 14e9fb711fe018430135cb56b8a1aeacb3da23bb Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 12:58:46 +0200
Subject: [PATCH 03/13] fix cmd

---
 .github/workflows/CI_docusaurus_sync.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index d410149acf..706b8abf20 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -54,7 +54,7 @@ jobs:
       - name: Generate docs
         working-directory: ${{ steps.pathfinder.outputs.project_path }}
 
-        run: hatch run docs
+        run: hatch run pydoc-markdown pydoc/config_docusaurus.yml
 
       - name: Upload docs artifact
         uses: actions/upload-artifact@v4

From 7684b4d79d3b963ffbe574cec142126d7cd75462 Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 13:02:19 +0200
Subject: [PATCH 04/13] missing env

---
 .github/workflows/CI_docusaurus_sync.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index 706b8abf20..f4ea7c551a 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -90,6 +90,8 @@ jobs:
 
       - name: Sync docs
         shell: python
+        env:
+          ARTIFACT_NAME: ${{ needs.generate-docs.outputs.artifact_name }}
         run: |
           import os
           import shutil

From be6b0ae01570b00ed4f6d7eaa2f02b66ff139c27 Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 13:06:53 +0200
Subject: [PATCH 05/13] fix for directory structure

---
 .github/workflows/CI_docusaurus_sync.yml | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index f4ea7c551a..11056b5b58 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -88,6 +88,10 @@ jobs:
         with:
           name: ${{ needs.generate-docs.outputs.artifact_name }}
 
+      - name: print dir structure
+        run: |
+          find . | sed -e "s/[^-][^\/]*\// |/g" -e "s/|\([^ ]\)/|-\1/"
+
       - name: Sync docs
         shell: python
         env:
@@ -97,15 +101,16 @@ jobs:
           import shutil
           # Copy the artifact markdown to docs-website/reference/integrations_api
           artifact_fname = os.environ['ARTIFACT_NAME']+'.md'
-          haystack_docs_path = "docs-website/reference/integrations_api/"
+          haystack_docs_path = "haystack/docs-website/reference/integrations_api/"
           shutil.copy(artifact_fname, haystack_docs_path)
 
           # loop over docs-website/reference_versioned_docs subfolders and copy the artifact markdown to the corresponding folder
-          for folder in os.listdir("docs-website/reference_versioned_docs"):
-            shutil.copy(artifact_fname, "docs-website/reference_versioned_docs/" + folder + "/" + artifact_fname)
+          for folder in os.listdir("haystack/docs-website/reference_versioned_docs"):
+            shutil.copy(artifact_fname, "haystack/docs-website/reference_versioned_docs/" + folder + "/" + artifact_fname)
 
           # remove the artifact markdown
           os.remove(artifact_fname)
 
       - name: Print git status
+        working-directory: haystack
         run: git status
\ No newline at end of file

From a8feced5328aae60be43c8c860c0870de6c16c4b Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 13:09:40 +0200
Subject: [PATCH 06/13] retry

---
 .github/workflows/CI_docusaurus_sync.yml | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index 11056b5b58..72ee2526c7 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -90,7 +90,7 @@ jobs:
 
       - name: print dir structure
         run: |
-          find . | sed -e "s/[^-][^\/]*\// |/g" -e "s/|\([^ ]\)/|-\1/"
+          ls -lrth
 
       - name: Sync docs
         shell: python
@@ -99,14 +99,17 @@ jobs:
         run: |
           import os
           import shutil
+
+          print(os.listdir("."))
+
           # Copy the artifact markdown to docs-website/reference/integrations_api
           artifact_fname = os.environ['ARTIFACT_NAME']+'.md'
-          haystack_docs_path = "haystack/docs-website/reference/integrations_api/"
+          haystack_docs_path = "docs-website/reference/integrations_api/"
           shutil.copy(artifact_fname, haystack_docs_path)
 
           # loop over docs-website/reference_versioned_docs subfolders and copy the artifact markdown to the corresponding folder
-          for folder in os.listdir("haystack/docs-website/reference_versioned_docs"):
-            shutil.copy(artifact_fname, "haystack/docs-website/reference_versioned_docs/" + folder + "/" + artifact_fname)
+          for folder in os.listdir("docs-website/reference_versioned_docs"):
+            shutil.copy(artifact_fname, "docs-website/reference_versioned_docs/" + folder + "/" + artifact_fname)
 
           # remove the artifact markdown
           os.remove(artifact_fname)

From b8e948557f7e050cdc3a0507145556b4b7467dc0 Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 13:12:27 +0200
Subject: [PATCH 07/13] fix integrations API folder name

---
 .github/workflows/CI_docusaurus_sync.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index 72ee2526c7..72be7e22f4 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -102,9 +102,9 @@ jobs:
 
           print(os.listdir("."))
 
-          # Copy the artifact markdown to docs-website/reference/integrations_api
+          # Copy the artifact markdown to docs-website/reference/integrations-api
           artifact_fname = os.environ['ARTIFACT_NAME']+'.md'
-          haystack_docs_path = "docs-website/reference/integrations_api/"
+          haystack_docs_path = "docs-website/reference/integrations-api/"
           shutil.copy(artifact_fname, haystack_docs_path)
 
           # loop over docs-website/reference_versioned_docs subfolders and copy the artifact markdown to the corresponding folder

From 9c75c6ab6082ed88e5ed097991a4a6092ed80ed5 Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 14:02:27 +0200
Subject: [PATCH 08/13] hatch is not needed

---
 .github/workflows/CI_docusaurus_sync.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index 72be7e22f4..5aa2824521 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -38,7 +38,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -U haystack-pydoc-tools hatch
+          pip install -U haystack-pydoc-tools
 
       - name: Get project folder
         id: pathfinder
@@ -54,7 +54,7 @@ jobs:
       - name: Generate docs
         working-directory: ${{ steps.pathfinder.outputs.project_path }}
 
-        run: hatch run pydoc-markdown pydoc/config_docusaurus.yml
+        run: pydoc-markdown pydoc/config_docusaurus.yml
 
       - name: Upload docs artifact
         uses: actions/upload-artifact@v4

From 0a64609267ced8d5432ad5cd4293cd70c1c2352d Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 14:48:26 +0200
Subject: [PATCH 09/13] improvements

---
 .github/workflows/CI_docusaurus_sync.yml | 46 +++++++++++-------------
 1 file changed, 20 insertions(+), 26 deletions(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index 5aa2824521..cebb742b4a 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -21,10 +21,10 @@ env:
   TAG: integrations/qdrant-v1.0.0
 
 jobs:
-  generate-docs:
+  generate-api-reference:
     runs-on: ubuntu-latest
     outputs:
-      artifact_name: ${{ steps.pathfinder.outputs.docusaurus_fname }}
+      artifact_filename: ${{ steps.pathfinder.outputs.docusaurus_filename }}
 
     steps:
       - name: Checkout this repo
@@ -46,10 +46,10 @@ jobs:
         run: |
           import os
           project_path = os.environ["TAG"].rsplit("-", maxsplit=1)[0]
-          docusaurus_fname = project_path.split("/")[-1]
+          docusaurus_filename = project_path.split("/")[-1]+'.md'
           with open(os.environ['GITHUB_OUTPUT'], 'a') as f:
             print(f'project_path={project_path}', file=f)
-            print(f'docusaurus_fname={docusaurus_fname}', file=f)
+            print(f'docusaurus_filename={docusaurus_filename}', file=f)
 
       - name: Generate docs
         working-directory: ${{ steps.pathfinder.outputs.project_path }}
@@ -59,16 +59,16 @@ jobs:
       - name: Upload docs artifact
         uses: actions/upload-artifact@v4
         with:
-          name: ${{ steps.pathfinder.outputs.docusaurus_fname }}
-          path: ${{ steps.pathfinder.outputs.project_path }}/${{ steps.pathfinder.outputs.docusaurus_fname }}.md
+          name: ${{ steps.pathfinder.outputs.docusaurus_filename }}
+          path: ${{ steps.pathfinder.outputs.project_path }}/${{ steps.pathfinder.outputs.docusaurus_filename }}
           if-no-files-found: error
           retention-days: 1
           overwrite: true
 
 
-  sync-docs:
+  sync-api-reference:
     runs-on: ubuntu-latest
-    needs: generate-docs
+    needs: generate-api-reference
     
     steps:
       - name: Checkout Haystack repo
@@ -83,36 +83,30 @@ jobs:
         with:
           python-version: "3.10"          
 
-      - name: Download docs artifact
+      - name: Download API reference artifact
         uses: actions/download-artifact@v4
         with:
-          name: ${{ needs.generate-docs.outputs.artifact_name }}
+          name: ${{ needs.generate-api-reference.outputs.artifact_filename }}
 
-      - name: print dir structure
-        run: |
-          ls -lrth
-
-      - name: Sync docs
+      - name: Sync API reference
         shell: python
         env:
-          ARTIFACT_NAME: ${{ needs.generate-docs.outputs.artifact_name }}
+          ARTIFACT_FILENAME: ${{ needs.generate-api-reference.outputs.artifact_filename }}
         run: |
           import os
           import shutil
 
-          print(os.listdir("."))
+          artifact_filename = os.environ['ARTIFACT_FILENAME']
 
-          # Copy the artifact markdown to docs-website/reference/integrations-api
-          artifact_fname = os.environ['ARTIFACT_NAME']+'.md'
-          haystack_docs_path = "docs-website/reference/integrations-api/"
-          shutil.copy(artifact_fname, haystack_docs_path)
+          # Copy to main API reference
+          shutil.copy(artifact_filename, "docs-website/reference/integrations-api/")
 
-          # loop over docs-website/reference_versioned_docs subfolders and copy the artifact markdown to the corresponding folder
-          for folder in os.listdir("docs-website/reference_versioned_docs"):
-            shutil.copy(artifact_fname, "docs-website/reference_versioned_docs/" + folder + "/" + artifact_fname)
+          # Copy to versioned API reference
+          for element in os.scandir("docs-website/reference_versioned_docs"):
+              if element.is_dir():
+                  shutil.copy(artifact_filename, element.path)
 
-          # remove the artifact markdown
-          os.remove(artifact_fname)
+          os.remove(artifact_filename)
 
       - name: Print git status
         working-directory: haystack

From 882cf84a32559007c1db82617fc26067b662f8e5 Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 15:30:47 +0200
Subject: [PATCH 10/13] refinements

---
 .github/workflows/CI_docusaurus_sync.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index cebb742b4a..e77dea0f8b 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -51,12 +51,12 @@ jobs:
             print(f'project_path={project_path}', file=f)
             print(f'docusaurus_filename={docusaurus_filename}', file=f)
 
-      - name: Generate docs
+      - name: Generate API reference
         working-directory: ${{ steps.pathfinder.outputs.project_path }}
 
         run: pydoc-markdown pydoc/config_docusaurus.yml
 
-      - name: Upload docs artifact
+      - name: Upload API reference artifact
         uses: actions/upload-artifact@v4
         with:
           name: ${{ steps.pathfinder.outputs.docusaurus_filename }}

From 50202e2b29310340d7ac65c94f7a1f77c4e97b08 Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 15:37:29 +0200
Subject: [PATCH 11/13] try creating PR

---
 .github/workflows/CI_docusaurus_sync.yml | 24 ++++++++++++++++++------
 1 file changed, 18 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index e77dea0f8b..8bb2248d3c 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -46,7 +46,7 @@ jobs:
         run: |
           import os
           project_path = os.environ["TAG"].rsplit("-", maxsplit=1)[0]
-          docusaurus_filename = project_path.split("/")[-1]+'.md'
+          docusaurus_filename = project_path.split("/")[-1]
           with open(os.environ['GITHUB_OUTPUT'], 'a') as f:
             print(f'project_path={project_path}', file=f)
             print(f'docusaurus_filename={docusaurus_filename}', file=f)
@@ -60,7 +60,7 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: ${{ steps.pathfinder.outputs.docusaurus_filename }}
-          path: ${{ steps.pathfinder.outputs.project_path }}/${{ steps.pathfinder.outputs.docusaurus_filename }}
+          path: ${{ steps.pathfinder.outputs.project_path }}/${{ steps.pathfinder.outputs.docusaurus_filename }}.md
           if-no-files-found: error
           retention-days: 1
           overwrite: true
@@ -96,7 +96,7 @@ jobs:
           import os
           import shutil
 
-          artifact_filename = os.environ['ARTIFACT_FILENAME']
+          artifact_filename = os.environ['ARTIFACT_FILENAME']+'.md'
 
           # Copy to main API reference
           shutil.copy(artifact_filename, "docs-website/reference/integrations-api/")
@@ -108,6 +108,18 @@ jobs:
 
           os.remove(artifact_filename)
 
-      - name: Print git status
-        working-directory: haystack
-        run: git status
\ No newline at end of file
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v7
+        env:
+          PROJECT_NAME: ${{ needs.generate-api-reference.outputs.artifact_filename }}
+        with:
+          token: ${{ secrets.HAYSTACK_BOT_TOKEN }}
+          commit-message: "Sync Core Integrations API reference (${{ env.PROJECT_NAME }}) on Docusaurus"
+          branch: sync-docusaurus-api-reference-${{ env.PROJECT_NAME }}
+          base: main
+          title: "docs: sync Core Integrations API reference (${{ env.PROJECT_NAME }}) on Docusaurus"
+          add-paths: |
+            docs-website
+          body: |
+            This PR syncs the Core Integrations API reference (${{ env.PROJECT_NAME }}) on Docusaurus. Just approve and merge it.
+          draft: true
\ No newline at end of file

From 8f5e927f9f6f44936e71c359aad6fb78c376c47f Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 15:56:07 +0200
Subject: [PATCH 12/13] better vars names

---
 .github/workflows/CI_docusaurus_sync.yml | 28 ++++++++++++------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index 8bb2248d3c..6fabe4e497 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -10,7 +10,7 @@ on:
   workflow_dispatch: # Activate this workflow manually
     inputs:
       tag:
-        description: "Tag with this format: integrations/<INTEGRATION_FOLDER_NAME>-v1.0.0"
+        description: "Tag with this format: integrations/<INTEGRATION_FOLDER_NAME>-v1.0.0. When running this workflow manually, version is irrelevant so you can use any value."
         required: true
         type: string
         default: integrations/<INTEGRATION_FOLDER_NAME>-v1.0.0
@@ -24,7 +24,7 @@ jobs:
   generate-api-reference:
     runs-on: ubuntu-latest
     outputs:
-      artifact_filename: ${{ steps.pathfinder.outputs.docusaurus_filename }}
+      integration_name: ${{ steps.pathfinder.outputs.integration_name }}
 
     steps:
       - name: Checkout this repo
@@ -46,10 +46,10 @@ jobs:
         run: |
           import os
           project_path = os.environ["TAG"].rsplit("-", maxsplit=1)[0]
-          docusaurus_filename = project_path.split("/")[-1]
+          integration_name = project_path.split("/")[-1]
           with open(os.environ['GITHUB_OUTPUT'], 'a') as f:
             print(f'project_path={project_path}', file=f)
-            print(f'docusaurus_filename={docusaurus_filename}', file=f)
+            print(f'integration_name={integration_name}', file=f)
 
       - name: Generate API reference
         working-directory: ${{ steps.pathfinder.outputs.project_path }}
@@ -59,8 +59,8 @@ jobs:
       - name: Upload API reference artifact
         uses: actions/upload-artifact@v4
         with:
-          name: ${{ steps.pathfinder.outputs.docusaurus_filename }}
-          path: ${{ steps.pathfinder.outputs.project_path }}/${{ steps.pathfinder.outputs.docusaurus_filename }}.md
+          name: ${{ steps.pathfinder.outputs.integration_name }}
+          path: ${{ steps.pathfinder.outputs.project_path }}/${{ steps.pathfinder.outputs.integration_name }}.md
           if-no-files-found: error
           retention-days: 1
           overwrite: true
@@ -86,17 +86,17 @@ jobs:
       - name: Download API reference artifact
         uses: actions/download-artifact@v4
         with:
-          name: ${{ needs.generate-api-reference.outputs.artifact_filename }}
+          name: ${{ needs.generate-api-reference.outputs.integration_name }}
 
       - name: Sync API reference
         shell: python
         env:
-          ARTIFACT_FILENAME: ${{ needs.generate-api-reference.outputs.artifact_filename }}
+          INTEGRATION_NAME: ${{ needs.generate-api-reference.outputs.integration_name }}
         run: |
           import os
           import shutil
 
-          artifact_filename = os.environ['ARTIFACT_FILENAME']+'.md'
+          artifact_filename = os.environ['INTEGRATION_NAME']+'.md'
 
           # Copy to main API reference
           shutil.copy(artifact_filename, "docs-website/reference/integrations-api/")
@@ -111,15 +111,15 @@ jobs:
       - name: Create Pull Request
         uses: peter-evans/create-pull-request@v7
         env:
-          PROJECT_NAME: ${{ needs.generate-api-reference.outputs.artifact_filename }}
+          INTEGRATION_NAME: ${{ needs.generate-api-reference.outputs.integration_name }}
         with:
           token: ${{ secrets.HAYSTACK_BOT_TOKEN }}
-          commit-message: "Sync Core Integrations API reference (${{ env.PROJECT_NAME }}) on Docusaurus"
-          branch: sync-docusaurus-api-reference-${{ env.PROJECT_NAME }}
+          commit-message: "Sync Core Integrations API reference (${{ env.INTEGRATION_NAME }}) on Docusaurus"
+          branch: sync-docusaurus-api-reference-${{ env.INTEGRATION_NAME }}
           base: main
-          title: "docs: sync Core Integrations API reference (${{ env.PROJECT_NAME }}) on Docusaurus"
+          title: "docs: sync Core Integrations API reference (${{ env.INTEGRATION_NAME }}) on Docusaurus"
           add-paths: |
             docs-website
           body: |
-            This PR syncs the Core Integrations API reference (${{ env.PROJECT_NAME }}) on Docusaurus. Just approve and merge it.
+            This PR syncs the Core Integrations API reference (${{ env.INTEGRATION_NAME }}) on Docusaurus. Just approve and merge it.
           draft: true
\ No newline at end of file

From 38fa8f7dd151d92825f5c6079203c551fbf6aec9 Mon Sep 17 00:00:00 2001
From: anakin87 <stefanofiorucci@gmail.com>
Date: Wed, 22 Oct 2025 16:01:20 +0200
Subject: [PATCH 13/13] clean up

---
 .github/workflows/CI_docusaurus_sync.yml | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/CI_docusaurus_sync.yml b/.github/workflows/CI_docusaurus_sync.yml
index 6fabe4e497..fafe90572d 100644
--- a/.github/workflows/CI_docusaurus_sync.yml
+++ b/.github/workflows/CI_docusaurus_sync.yml
@@ -1,8 +1,6 @@
 name: Core / Sync API reference with Docusaurus
 
 on:
-  # for testing purposes
-  pull_request:
   push:
     tags:
       - "**-v[0-9].[0-9]+.[0-9]+"
@@ -16,9 +14,7 @@ on:
         default: integrations/<INTEGRATION_FOLDER_NAME>-v1.0.0
 
 env:
-  # TAG: ${{ inputs.tag || github.ref_name}}
-  # for testing purposes
-  TAG: integrations/qdrant-v1.0.0
+  TAG: ${{ inputs.tag || github.ref_name }}
 
 jobs:
   generate-api-reference:
@@ -121,5 +117,4 @@ jobs:
           add-paths: |
             docs-website
           body: |
-            This PR syncs the Core Integrations API reference (${{ env.INTEGRATION_NAME }}) on Docusaurus. Just approve and merge it.
-          draft: true
\ No newline at end of file
+            This PR syncs the Core Integrations API reference (${{ env.INTEGRATION_NAME }}) on Docusaurus. Just approve and merge it.
\ No newline at end of file