Using User Stories in Code Branches

This page explains how to connect Jira user stories to branches in Revvy, ensuring that development work is always tied to specific requirements.

User stories provide context for development. By linking Jira stories to branches in Revvy, you can ensure every change is traceable to a requirement or feature request. Stories can be added during branch creation or later from the Related stories tab.

Creating a Branch with Stories

  1. Go to the Code tab and click + Create Branch.

  2. Fill in the branch details:

    • New branch name (e.g., Feature_Login).

    • Source branch (e.g., main).

    • Integration (select Jira).

    • Project (choose the Jira project, e.g., Flosum).

    • Stories (choose from available Jira stories).

  3. Click Create branch.

Example: A branch is created from main with Jira project Flosum, linked to stories FLOS-23 and FLOS-24.

Once the Jira stories are added, they will be displayed in the branch’s Related stories tab.

Adding Stories to an Existing Branch

  1. Open the branch and navigate to the Related stories tab.

  2. Click + Add stories.

  3. Select the Integration (Jira).

  4. Choose a Project.

  5. Select one or more Stories.

  6. Click Add.

Stories will now appear in the branch’s Related stories list with details such as:

  • Issue key (e.g., FLOS-23)

  • Priority (Medium, High, etc.)

  • Status (e.g., Selected for Development)

  • Assignee

  • Summary

Managing Stories in a Branch

  • Use the search bar to quickly find linked stories.

  • Filter by priority or assignee.

  • Remove stories using the recycle bin icon if they’re no longer relevant.

Example: A developer links FLOS-23: Working On User Story Feature1 and FLOS-24: Working On User Story Feature2 to the JiraBranch.

Best Practices

  • Always link at least one user story when creating feature branches.

  • Use story filters (priority/assignee) to manage large projects efficiently.

  • Keep story links updated — remove stories once they’re delivered.

  • Ensure Jira integration is active before creating story-linked branches.

Last updated

Was this helpful?