workflow naming

Author: swissiety

.github/workflows/doc_deployment.yml

@@ -0,0 +1,40 @@
+name: Documentation Deployment
+
+on:
+  push:
+    branches:
+      - develop
+    tags:
+      - '*'
+
+concurrency:
+  group: gh-pages
+
+jobs:
+  deploy-doc:
+    name: Deploy Stable Documentation
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Configuration
+        shell: bash
+        run: |
+          if [[ "${{ github.event_name }}" != "push" ]]; then
+            # use tag name
+            VERSION="${{ github.ref_name }}"
+          else
+            # use extracted version from pom.xml on pushes i.e. on develop
+            VERSION="develop"
+          fi  
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.ref }}
+
+      - name: Deploy Documentation
+        uses: secure-software-engineering/actions/documentation/deployment@develop
+        with:
+          version: ${{ env.version }}

.github/workflows/doc_preview.yml

@@ -1,10 +1,4 @@
-name: PR Documentation Preview
-
-permissions:
-  pages: write
-  deployments: write
-  contents: write
-  pull-requests: write
+name: Documentation Preview
 
 on:
   pull_request:
@@ -14,19 +8,24 @@ on:
       - synchronize
       - reopened
     paths:
-      - 'mkdocs.yml'
-      - 'docs/**'
-      - '.github/workflows/documentation-pr-preview.yml'
+      - mkdocs.yml
+      - docs/**
+      - .github/workflows/documentation-pr-preview.yml
 
-concurrency: pages
+concurrency:
+  group: gh-pages
 
 jobs:
   deploy-preview:
+    name: Preview documentation
     runs-on: ubuntu-latest
-    name: Deploy Documentation Preview
+    permissions:
+      contents: write
+      pull-requests: write      # for posting a comment
+
     steps:
-      - name: sad
-        uses: secure-software-engineering/actions/documentation/handle-pr-preview@develop
-        with:
-          preview-name: ${{ github.base_ref }}
-          title: "Preview: ${{ github.base_ref }}"
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Create Documentation Preview
+        uses: secure-software-engineering/actions/documentation/pr-preview@develop