feat: README update (onecx#620)

README.md

@@ -6,6 +6,52 @@ OneCx portal UI libraries
 
 [Changelog](CHANGELOG.md)
 
+# Release configuration
+
+OneCX Portal UI Libs is using https://semantic-release.gitbook.io/semantic-release[semantic-release]for packages release. In this repository the following branches are important in context of making new releases:
+
+- **main** - contains source code for `latest` distribution tag.
+- **develop** - contains source code for `rc` distribution tag with features for future release of OneCX.
+
+# Releasing libs
+
+The `main` branch contains the source code for the `latest` distribution tag of OneCX libraries. In order to release new version of libs, use `create-release` action to run the release workflow for **main branch**.
+
+## Release versioning
+
+Depending on the commits included for a release in the `main` branch, the version of the `latest` distribution tag varies. Below, a list of example version changes is presented:
+
+- Release fix commit - The patch version increments (e.g., `5.1.3` → `5.1.4`).
+- Release feat commit - The minor version increments (e.g., `5.1.3` → `5.2.0`).
+- Release commit with breaking change - The major version increments (e.g., `5.1.3` → `6.0.0`).
+- Release changes merged from pre-release branch - The major version increments (e.g., `5.1.3` → `6.0.0`).
+
+# Pre-releases
+
+The https://semantic-release.gitbook.io/semantic-release[semantic-release] allows to create pre-releases. In this repository, `develop` branch should contain source code which could be released as a release candidate.
+
+In order to release new version of pre-release (`rc` distribution tag) of OneCX libraries, use `create-release` action to run the release workflow for **develop branch**.
+
+## Pre-release versioning
+
+Depending on the commits included for a release in the `develop` branch, the version of the `rc` distribution tag varies. Below, a list of example version changes is presented:
+
+- Release fix commit - The patch version increments (e.g., `6.0.0-rc.3` → `6.0.0-rc.4`).
+- Release feat commit - The minor version increments (e.g., `6.0.0-rc.3` → `6.0.0-rc.4`).
+- Release commit with breaking change - The major version increments (e.g., `6.0.0-rc.3` → `7.0.0-rc.1`).
+- Release changes merged from pre-release branch - The major version increments (e.g., `6.0.0-rc.3` → `7.0.0-rc.1`).
+
+To find out more on pre-releases with semantic-release, please refer https://semantic-release.gitbook.io/semantic-release/recipes/release-workflow/pre-releases[here].
+
+# Porting changes from main to develop
+
+In some cases, there might be a requirement to make a change directly on a main branch (e.g., urgent fix for a client). In that scenario, the following should happen:
+
+- Change is prepared on the `main` branch
+- Libs are released via the `main` branch
+- The `main` branch is merged into `develop` branch
+- Libs pre-release is released via the `develop` branch
+
 # Update from v3 to v4 guide
 
-[Update guide](update-guide.md)
+[Update guide](update-guide.md)