From 969322ce01413885211a1dcaac8eee2f4eb26417 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 1 Apr 2026 13:17:04 +0000
Subject: [PATCH 1/5] Initial plan


From 911131b74795afbd35a0fd6e366d49fa0e2ce38b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 1 Apr 2026 13:18:47 +0000
Subject: [PATCH 2/5] docs: document versioning workflow and #SkipVersionBump
 in README

Agent-Logs-Url: https://github.com/AbsaOSS/cps-shared-ui/sessions/3972851c-8ae7-490f-bda0-07dbb3c3fa91

Co-authored-by: lukasmatta <4323927+lukasmatta@users.noreply.github.com>
---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index f52cbdf2..db027bdc 100644
--- a/README.md
+++ b/README.md
@@ -94,6 +94,23 @@ Execute `npm run generate-json-api` to generate documentation for any changes in
 
 See [playwright/README.md](playwright/README.md) for full details.
 
+#### Versioning and publishing
+
+The CI/CD pipeline automatically bumps the **minor version** and publishes the package to NPM on every push to `master` that touches files under `projects/cps-ui-kit/**`.
+
+To publish a **major** or **patch** version instead:
+
+1. Manually update the version in [`projects/cps-ui-kit/package.json`](projects/cps-ui-kit/package.json) to the desired version.
+2. Include `#SkipVersionBump` in the commit message so the pipeline skips the automatic minor bump and publishes exactly the version you set.
+
+Example commit message:
+
+```
+chore: release patch fix #SkipVersionBump
+```
+
+> **Note:** Without `#SkipVersionBump`, any manual version change in `package.json` will be overwritten by the automatic minor bump before publishing.
+
 #### Run accessibility tests
 
 The project uses [pa11y-ci](https://github.com/pa11y/pa11y-ci) to test all components for WCAG 2.0 AA compliance.

From 6fb4c64470f0e8f938b92fab2113268cda06e8a1 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 1 Apr 2026 13:29:44 +0000
Subject: [PATCH 3/5] docs: show #SkipVersionBump in commit footer per review
 feedback

Agent-Logs-Url: https://github.com/AbsaOSS/cps-shared-ui/sessions/5f996aaa-4d13-481e-b9f7-b323ed00220a

Co-authored-by: lukasmatta <4323927+lukasmatta@users.noreply.github.com>
---
 README.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index db027bdc..db6cffb8 100644
--- a/README.md
+++ b/README.md
@@ -103,10 +103,12 @@ To publish a **major** or **patch** version instead:
 1. Manually update the version in [`projects/cps-ui-kit/package.json`](projects/cps-ui-kit/package.json) to the desired version.
 2. Include `#SkipVersionBump` in the commit message so the pipeline skips the automatic minor bump and publishes exactly the version you set.
 
-Example commit message:
+Example commit message (the token is matched against the full message, so placing it in the footer is preferred):
 
 ```
-chore: release patch fix #SkipVersionBump
+chore: release patch fix
+
+#SkipVersionBump
 ```
 
 > **Note:** Without `#SkipVersionBump`, any manual version change in `package.json` will be overwritten by the automatic minor bump before publishing.

From 3954dfe2ebc1839e1a4893b6cfee30f7bc3751ab Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Luk=C3=A1=C5=A1=20Matta?=
 <lukasmatta@users.noreply.github.com>
Date: Wed, 1 Apr 2026 15:34:47 +0200
Subject: [PATCH 4/5] Update README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index db6cffb8..75d2988c 100644
--- a/README.md
+++ b/README.md
@@ -96,7 +96,7 @@ See [playwright/README.md](playwright/README.md) for full details.
 
 #### Versioning and publishing
 
-The CI/CD pipeline automatically bumps the **minor version** and publishes the package to NPM on every push to `master` that touches files under `projects/cps-ui-kit/**`.
+The CI/CD pipeline automatically bumps the **minor version** and publishes the package to NPM on every push to `master` that either touches files under `projects/cps-ui-kit/**` or modifies `.github/workflows/cps-ui-kit-publish.yml`.
 
 To publish a **major** or **patch** version instead:
 

From 9980977a6839ad9cef5865ed8e7cb18669ef88af Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Luk=C3=A1=C5=A1=20Matta?=
 <lukasmatta@users.noreply.github.com>
Date: Wed, 1 Apr 2026 15:35:13 +0200
Subject: [PATCH 5/5] Update README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 75d2988c..225e7113 100644
--- a/README.md
+++ b/README.md
@@ -103,7 +103,7 @@ To publish a **major** or **patch** version instead:
 1. Manually update the version in [`projects/cps-ui-kit/package.json`](projects/cps-ui-kit/package.json) to the desired version.
 2. Include `#SkipVersionBump` in the commit message so the pipeline skips the automatic minor bump and publishes exactly the version you set.
 
-Example commit message (the token is matched against the full message, so placing it in the footer is preferred):
+Example commit message for the **final/head commit in the push** (the workflow checks only `github.event.head_commit.message`, so `#SkipVersionBump` must appear in the last commit message; the token is matched against the full message, so placing it in the footer is preferred):
 
 ```
 chore: release patch fix