Working with User Stories

A user story carries the change(s) to be delivered. How changes are attached depends on the branching model of each application involved.

Add MTAR Applications

To associate MTAR applications with a User Story:

1. Navigate to Change Management and click User Stories.

2. Click Create New User Story.

1. Enter the required details and click Create.

1. Click Actions, and then click Edit.

2. In the User Story section, the Change Type field displays two options:

   • Normal

   • Hotfix

3. Select the required change type.

4. Normal: The user story follows the standard release process. Branches are created and promoted using the application's regular branch configuration.

   Hotfix: The user story is used for urgent fixes. ReleaseOwl always assigns the hotfix branch to the user story. Promotion is carried out using the application's Hotfix configuration, so the fix can be delivered to production without waiting for the regular release.

Note: Even if the application uses the Cherry-Pick model, a Hotfix user story works only with branches — you add branches to the user story, not individual commits.

1. In the MTAR Applications section, click Add.

Step 1: MTAR Applications

The MTAR Applications step displays all registered MTAR applications.

1. Select the required MTAR application.

2. Review the application details, including:

   • Application Name

   • Description

   • Repository URL

   • Branching Model

3. Click Next.

Step 2: Source Reference

When adding the application to a user story, the Source Reference step lets you either create a new feature branch or reference an existing one.

Field	Type	Description
Select	Radio	“Create <Feature/Hotfix> Branch” to have ReleaseOwl create the branch in Git, or “I Already Have a <Feature/Hotfix> Branch” to reference an existing branch.
Branch name	Text	The feature/hotfix branch name (e.g. hotfix/DP-488).
From Branch	Dropdown	The base branch the new branch is cut from. Defaults to the application’s “Create Feature Branch From Branch” value; can be overridden.
Create Branch	Button	Creates the branch in the Git repository.

• If I Already Have a Feature Branch is selected, Enter the existing feature branch and click Finish.

Cherry Pick Model

In the Cherry-Pick model no feature branch is created. Instead, you select the commits related to the user story. The available commits are populated from the application’s development branch — the landscape branch flagged as “Development Branch” . The selected commits are cherry-picked onto the target environment branches during promotion.

Step 3 — Source Reference (Hotfix Branch)

Because the change type is Hotfix, the Source Reference step works with a hotfix branch:

Field	Type	Description
Select	Radio	Create Hotfix Branch — ReleaseOwl creates the hotfix branch in the Git repository; or I Already Have a Hotfix Branch — reference a branch that already exists.
Hotfix Branch	Text	The hotfix branch name.
From Branch	Dropdown	The dropdown lists the application's environment branches . For a production fix, select the branch running in production so the hotfix contains exactly what is live plus your fix.

• Click Finish to create the hotfix branch and complete the assignment.

• If I Already Have a Hotfix Branch is selected, enter the existing hotfix branch name and click Finish.

Edit Feature Branch / Commits

You can edit the Feature Branch or the selected commits after an MTAR application has been added to the User Story.

To edit the source reference:

1. In the MTAR Applications section, click the Actions button corresponding to the required MTAR application.

2. Click Edit Feature Branch.

1. Update the Feature Branch (for the Feature Branch Model) or modify the selected commits (for the Cherry Pick Model).

2. Click Save /Add to apply the changes.

User Story Actions

The following actions are available on the User Story toolbar:

• Validate – Validates the User Story against the configured target environment and generates a Validation Report. Depending on the Release Pipeline and associated Build Pipeline configuration, the validation may include artifact validation, dependency and impact analysis, static code analysis, SonarQube analysis, ESLint validation, OPA5 test execution, and build verification.

• Promote – Promotes the User Story to the next stage in the release pipeline.

• Save – Saves the changes made to the User Story. Ensure that you click Save before clicking Promote.

• Refresh – Refreshes the User Story and reloads the latest information.

• Activity Log- Click Activity Log to view the complete history of actions performed on the User Story.

• Release Package Details: Click Release Package Details to view the release package information associated with the User Story.

• Export User Story : Click Export User Story to export the User Story details.

User Story promotion

• Initiated manually from the user story.

• Source is the story’s feature branch (Feature Branch model) or selected commits (Cherry-Pick model).

• Each user story is processed individually. In the Feature Branch model the feature branch is merged into each environment branch as the story advances (Development → QA → Production), with the source constant and only the Target Environment changing per stage.