📝 docs: improve workflow readability with comments for complex conditions

.gitea/workflows/ci-cd.yaml

@@ -6,6 +6,19 @@
 name: CI/CD Pipeline
 
 on:
+  # Workflow dispatch with optional parameters for flexible testing
+  workflow_dispatch:
+    inputs:
+      skip_ci:
+        description: 'Skip CI pipeline and go straight to Docker push'
+        required: false
+        type: boolean
+        default: false
+      docker_only:
+        description: 'Run only Docker push steps (requires skip_ci=true)'
+        required: false
+        type: boolean
+        default: false
   workflow_dispatch:
     inputs:
       skip_ci:
@@ -143,6 +156,7 @@ jobs:
     name: CI Pipeline
     needs: build-cache
     runs-on: ubuntu-latest-ca
+    # Skip conditions: standard skip ci + actor check + respect skip_ci input
     if: "!contains(github.event.head_commit.message, '[skip ci]') && github.actor != 'ci-bot' && (!github.event.inputs.skip_ci || github.event.inputs.skip_ci == 'false')"
     
     container:
@@ -321,6 +335,7 @@ jobs:
     name: Docker Push
     needs: build-cache
     runs-on: ubuntu-latest-ca
+    # Run conditions: standard checks + main branch + feature branch + docker_only override
     if: "!contains(github.event.head_commit.message, '[skip ci]') && github.actor != 'ci-bot' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/feature/move-docker-job' || github.event.inputs.docker_only == 'true')"
     
     steps: