ci: refactor push and pr ci

refactors the CI to only run on prs and makes only release and docs publication
run on pushes on main.

Signed-off-by: Luca Zaninotto <luca.zaninotto@secomind.com>

Author: lusergit

.github/actions/backend/publish-doc.yaml

@@ -27,13 +27,6 @@ inputs:
 runs:
   using: "composite"
   steps:
-    # Upload as an artifact the generated HTML
-    - name: Upload HTML documentation
-      uses: actions/upload-artifact@v6
-      with:
-        name: docs_html
-        path: ${{ inputs.docs }}
-
     # Commit and push changes to the docs repository
     - name: Commit files
       working-directory: ${{ inputs.docs }}

.github/workflows/docs-workflow.yaml

@@ -19,28 +19,16 @@
 
 name: Edgehog docs generation
 
+# publish Generate and publish docs on pushes on main (or release branches) only
+# when backend or frontend files are touched.
 on:
-  push:
-    paths:
-      # Documentation pages
-      - "backend/docs/**"
-      # Schema files
-      - "backend/lib/edgehog_web/admin_api/**"
-      - "backend/lib/edgehog_web/schema.ex"
-      - "backend/lib/edgehog_web/schema/**"
-      # Ash resources, including new Ash domains
-      - "backend/lib/edgehog/**"
-      - "backend/mix.exs"
-      - "backend/mix.lock"
-      # SpectaQL configuration file
-      - "backend/.spectaql-config.yaml"
-      # The action itself, Elixir and Node.js versions
-      - ".tool-versions"
-      - ".github/workflows/docs-workflow.yaml"
-    branches:
-      # Create the snapshot only when it matters
-      - "main"
-      - "release-*"
+  workflow_call:
+    inputs:
+      release-made:
+        required: true
+        type: boolean
+      release-version:
+        type: string
 
 concurrency:
   group: "${{ github.workflow }}-${{ github.ref }}"
@@ -78,11 +66,17 @@ jobs:
           repository: edgehog-device-manager/edgehog-astarte-interfaces
           path: edgehog-astarte-interfaces
           show-progress: false
-      - uses: .github/actions/gen-doc.yaml
+      - name: Compute docs version
+        id: compute-version
+        run: |
+          version=$(${{ inputs.release-made }} && echo ${{ inputs.release-version }} || echo "snapshot")
+          echo "version=$version" >> $GITHUB_OUTPUT
+      - uses: .github/actions/backend/gen-doc.yaml
         with:
           edgehog: edgehog
           docs: docs
           astarte-interfaces: edgehog-astarte-interfaces
-      - uses: .github/actions/publish-doc.yaml
+          version: ${{ steps.compute-version.outputs.version }}
+      - uses: .github/actions/backend/publish-doc.yaml
         with:
           docs: docs

.github/workflows/release-please.yaml .github/workflows/release-ci.yaml.github/workflows/release-please.yaml renamed to .github/workflows/release-ci.yaml

@@ -26,13 +26,19 @@ permissions:
   issues: write
   pull-requests: write
 
-name: release-please
+name: Release CI
 
 jobs:
-  release-please:
+  make-release:
     runs-on: ubuntu-latest
     steps:
       - uses: googleapis/release-please-action@v4
         with:
           config-file: .github/release-please/config.json
           manifest-file: .github/release-please/manifest.json
+  publish-docs:
+    needs: [make-release]
+    uses: .github/workflows/docs-workflow.yaml
+    with:
+      release-made: ${{ needs.make-release.outputs.backend--release_created }}
+      release-version: ${{ needs.make-release.outputs.backend--version }}