Planning a version

Still need help?

The Atlassian Community is here for you.

Ask the community

You've got a backlog full of exciting stories that are just waiting to be turned into an amazing application. It's time to plan a version! 

The documentation in this section will help you set up a new version for your Jira Software project. This includes creating the version, setting up epics, and assigning work to a version.

Search the topics in 'Planning a version':

Overview

Creating and configuring a version

A version is a set of features and fixes released together as a single update to your application. Assigning issues to versions helps you plan the order in which new features (stories) for your application will be released to your customers.

Learn more: Configuring versions in a Scrum project and Configuring versions in a Kanban project

Working with epics
(Scrum boards only)

An epic captures a large body of work. It is essentially a large user story that can be broken down into a number of smaller stories. It may take several sprints to complete an epic. You might use epics to capture broader themes in a release, e.g. performance-related work.

Learn more: Working with epics

Branching your repository

You can use a number of different branching strategies, including task branching, feature branching, and release branching. You'll need to decide how much work should to be contained in a branch before merging, when deciding on a strategy.  

If you decide to use the release branching model, you'll create your branches at the start of a version. For example, you might create a branch for your last version, so you can continue with bugfix work on that branch, while new development work is done on the master branch.

Learn more: Branches (Bitbucket Server documentation), Branching a repository (Bitbucket Cloud documentation), Creating and deleting branches (GitHub documentation)

Tip: You can create a branch via an issue, if Jira Software is connected to Bitbucket Cloud, Bitbucket Server, or GitHub.

Already planned a version?

Next: Get to work!

Project lifecycle

  NEW PROJECT   BACKLOG    NEW VERSION    WORK    RELEASE    REPORTING

Last modified on Oct 31, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.