docs: readme & gh workflows updated (#8)

Author: wchomik

.github/workflows/build_verify.yml

@@ -1,17 +1,16 @@
-name: Build and Verify
+name: "🔍 OCM: Build & Verify"
+
+run-name: >-
+  ${{ github.event_name == 'workflow_dispatch'
+    && format('Manual Package & Verify')
+    || format('Automatic Package & Verify') }}
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
   cancel-in-progress: true
 
 on:
   workflow_dispatch: {}
-  # push:
-  #   branches:
-  #     - main
-  #   paths:
-  #     - "**/helmfile/**"
-  #     - "**/component-constructor.yaml"
   pull_request:
     branches:
       - main
@@ -72,3 +71,4 @@ jobs:
           status: ${{ job.status }}
           sha: ${{ env.commit }}
           targetUrl: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          context: OCM Build & Verify

.github/workflows/package_transfer.yaml

@@ -1,4 +1,4 @@
-name: OCM Package & Transfer
+name: "📦 OCM: Package, Release & Transfer"
 
 run-name: >-
   ${{ github.event_name == 'workflow_dispatch'
@@ -16,23 +16,12 @@ on:
         description: 'The version to set/publish the OCM packages as. E.g., "1.2.3". If not provided, the version will be auto-incremented based on the latest existing tag.'
         required: false
         type: string
-  # To ensure this workflow only runs after successful PR checks via "Build and Verify" workflow, you must:
-  # - block direct pushes to main by enabling branch protection rules
-  # - require "Build and Verify" workflow to pass before merging and uncomment the 'push' trigger below.
-  # This way we can be sure that all changes go through the PR process.
   push:
     branches:
       - main
     paths:
       - "**/helmfile/**"
       - "**/component-constructor.yaml"
-  # Alternatively, disable the 'push' trigger and use 'workflow_run' to ensure this workflow is triggered by the "Build and Verify" workflow.
-  # workflow_run:
-  #   workflows: ["Build and Verify"]
-  #   types:
-  #     - completed
-  #   branches:
-  #     - main
 
 permissions:
   pull-requests: write

.github/workflows/re-find-constructors.yml

@@ -1,4 +1,4 @@
-name: Find Component Constructors
+name: 🔄 Find Component Constructors
 
 on:
   workflow_call:

.github/workflows/re-get-version.yml

@@ -1,4 +1,4 @@
-name: Get Version
+name: 🔄 Get Version
 
 on:
   workflow_call:

.github/workflows/re-publish-ocm.yaml

@@ -1,4 +1,4 @@
-name: Publish OCM Packages
+name: 🔄 Publish OCM Packages
 
 on:
   workflow_call: 

README.md

@@ -167,21 +167,34 @@ flowchart TB
 
 
 ### 🔄 Open Component Model Pipeline
-A Github Workflow [`.github/workflows/ocm-component-check.yml`](./.github/workflows/ocm-component-check.yml) is used to find, package and transfer all `./ocm/**/component-constructor.yaml` to an an OCI repository.
+
+Two GitHub Workflows manage the OCM component lifecycle:
+
+1. **[🔍 OCM: Build & Verify](./.github/workflows/build_verify.yml)** - Runs on pull requests to validate OCM components
+2. **[📦 OCM: Package, Release & Transfer](./.github/workflows/package_transfer.yaml)** - Packages and publishes OCM components on push to main or manual dispatch
+
+These workflows find, package, and transfer all `./ocm/**/component-constructor.yaml` to an OCI repository (ghcr.io).
 
 ```mermaid
 sequenceDiagram
+    autonumber
     participant Dev as 👨‍💻 Developer
     participant GH as 🐙 GitHub
-    participant GithubWorkflow as ⚙️ Github Workflow
+    participant BuildVerify as 🔍 OCM: Build & Verify
+    participant PackageTransfer as 📦 OCM: Package, Release & Transfer
+    participant Version as 🏷️ Version Management
     participant OCM as 📦 OCM
-    participant JFrog as 🏦 JFrog
-
-    Dev->>GH: 📤 Push Code
-    GH->>GithubWorkflow: 🚀 Trigger Build
-    GithubWorkflow->>OCM: 📦 Create Component
-    OCM->>JFrog: 🎯 Transfer Artifacts
-    JFrog-->>Dev: ✅ Build Complete
+    participant Registry as 🏦 OCI Registry
+    Dev->>GH: 📤 Push PR
+    GH->>BuildVerify: 🚀 Triggers on PR
+    BuildVerify->>GH: 📦 Build & Verify
+    Dev->>GH: 🔀 Merge to main
+    GH->>PackageTransfer: 🚀 Triggers on push
+    PackageTransfer->>Version: 🏷️ Get/Bump Version
+    Version-->>PackageTransfer: ✅ Version Ready
+    PackageTransfer->>OCM: 📦 Create & Transfer Components
+    OCM->>Registry: 🎯 Transfer Artifacts
+    Registry-->>Dev: ✅ Build Complete
 ```
 
 ### 🧩 Core Components
@@ -224,11 +237,11 @@ sequenceDiagram
 ```
 ├── .github/
 │   └── workflows/
-│       ├── build_verify.yml         # Build and Verify workflow (runs on PRs)
-│       ├── package_transfer.yaml    # OCM Package & Transfer workflow
-│       ├── re-find-constructors.yml # Find OCM component constructors
-│       ├── re-get-version.yml       # Version management workflow
-│       └── re-publish-ocm.yaml      # Publish OCM components workflow
+│       ├── build_verify.yml         # 🔍 OCM: Build & Verify workflow
+│       ├── package_transfer.yaml    # 📦 OCM: Package, Release & Transfer workflow
+│       ├── re-find-constructors.yml # 🔄 Find Component Constructors workflow
+│       ├── re-get-version.yml       # 🔄 Get Version workflow
+│       └── re-publish-ocm.yaml      # 🔄 Publish OCM components workflow
 ├── README.md                    # Comprehensive documentation (this file)
 ├── Makefile                     # Build and deployment automation
 ├── renovate.json                # Dependency update configuration
@@ -247,38 +260,15 @@ sequenceDiagram
 
 #### 🔄 Github Workflows
 
-```mermaid
-sequenceDiagram
-    autonumber
-    participant Dev as 👨‍💻 Developer
-    participant GH as 🐙 GitHub
-    participant BuildVerify as ⚙️ Build & Verify
-    participant PackageTransfer as ⚙️ Package & Transfer
-    participant Version as 🏷️ Version Management
-    participant OCM as 📦 OCM
-    participant Registry as 🏦 OCI Registry
-    Dev->>GH: 📤 Push PR
-    GH->>BuildVerify: 🚀 Triggers on PR
-    BuildVerify->>GH: 📦 Build & Verify
-    Dev->>GH: 🔀 Merge to main
-    GH->>PackageTransfer: 🚀 Triggers on push
-    PackageTransfer->>Version: 🏷️ Get/Bump Version
-    Version-->>PackageTransfer: ✅ Version Ready
-    PackageTransfer->>OCM: 📦 Create & Transfer Components
-    OCM->>Registry: 🎯 Transfer Artifacts
-    Registry-->>Dev: ✅ Build Complete
-```
-
 ##### `build_verify.yml`
-The Build and Verify workflow [`.github/workflows/build_verify.yml`](./.github/workflows/build_verify.yml) runs on pull requests and:
+The "🔍 OCM: Build & Verify" workflow [`.github/workflows/build_verify.yml`](./.github/workflows/build_verify.yml) runs on pull requests and:
 - Verifies OCM component constructors
 - Validates the overall build process
 
 ##### `package_transfer.yaml`
-The OCM Package & Transfer workflow [`.github/workflows/package_transfer.yaml`](./.github/workflows/package_transfer.yaml) is triggered on pushes to main branch or manual dispatch and:
+The "📦 OCM: Package, Release & Transfer" workflow [`.github/workflows/package_transfer.yaml`](./.github/workflows/package_transfer.yaml) is triggered on pushes to main branch or manual dispatch and:
 - Packages all OCM components defined in `./ocm/**/component-constructor.yaml`
 - Transfers components to OCI repository (ghcr.io)
-- Publishes ConfigMaps as OCI artifacts
 
 ##### `re-find-constructors.yml`
 A reusable workflow that scans the repository to find all `component-constructor.yaml` files. This workflow: