YouTrack Standalone 7.0 Help

Scrum Boards

This tutorial shows you how to create, configure, and use an agile board in YouTrack when you follow the Scrum development framework.

An Introduction to Scrum

Scrum is about developing features in a project in an iterative process. You work toward the final release of the product with smaller pre-releases that implement specific features. The features are also known as user stories.

A product owner in Scrum negotiates a schedule for the release of the final product. Each release has to meet a deadline. The period between the development start and the deadline is divided into smaller periods, usually two weeks to one month each. These time-boxed efforts are called sprints. Each sprint results in a viable pre-release version of the product.

Scrum Development with YouTrack

Every project in YouTrack tracks different types of issues like bug reports, feature requests, and tasks.

You can view the issues in a project issues by looking at the issues in a list or displaying the issues on an agile board. The cards on the agile board represent the same issues that are displayed in the list. The agile board, however, gives you a better visualization of the current project state and its progress. The board also includes a number of features that have been designed specifically to support Scrum development.

Configure Your Projects

Before you start to configure your Scrum board, take a minute to pick which projects you want to manage on the board and check that they are configured properly.

If you want to use a Scrum board with a new project, you can create the project and two agile boards simultaneously with the Scrum project template. For more information, see Scrum Project Template.

The primary agile board for Scrum development displays features (or user stories) as swimlanes on the board. Each card on the board represents a task that contributes to the development of the corresponding feature.

You can also create a second board to track the progress toward the development of the final product. This board shows epics as swimlanes, with cards that represent major features or user stories.

To support this configuration, all of the projects that you want to manage on a Scrum board should store these values in a custom field. Here, we have customized the set of values that are stored in the Type field.

/help/img/youtrack/7.0/scrum_tutorial_custom_fields.png

The columns on the board represent different states of delivery. The state is also stored in an issue field. The Scrum board uses a field that stores this value as a state type. When you move the card around the board, the field takes the value of the column that it has been moved to.

This example shows a state-type field that represents the states of delivery in the project. The field cannot be empty, which means that all new issues that are created in this project is displayed in the column that represents this value on the board when it is set.

/help/img/youtrack/7.0/scrum_tutorial_state_field.png

For best results, edit the set of values for an existing field that uses a state type. If you add a new state-type field to your projects, be sure to remove any additional state-type fields. Projects that use multiple state-type fields can be difficult to work with and require additional setup. For more information, see Custom Field Types.

Create the Board

Click the Agile Boards link in the header, select Board from the Create menu, then click the Scrum board button.

/help/img/youtrack/7.0/scrum_tutorial_board_config.png

Use the following guidelines to set up your new board:

SettingGuideline
NameGive the board a name.
ProjectsChoose the projects that you want to manage on the board.
Can View and Use BoardSelect the name of your project team from the list. To view cards and swimlanes and use the board, each member of the project team should also have permission to view and update issues in the selected projects.
Can Change Board SettingsIf you want other members of your project team to have access to the board settings, select the name of your project team from the list. Otherwise, only you can update the settings for the board.
BacklogIf you have already defined a saved search that contains all of the issues in your product backlog, select the Use existing option. Otherwise, select the Create new option.

The search query for a new backlog is formatted as follows:

project: <project(s)> has: -{Board <Board Name>} #Unresolved

This saved search displays all unresolved issues in the projects that are managed on the agile board that are not yet assigned to a sprint on the current board.

Saved SearchSelect the name of the saved search that you want to use for the backlog on the board. If you selected the Create new option, this setting displays the name that is assigned to the new saved search when the board is created.
QueryEnter an optional search query to filter which cards are displayed on the board. If you selected the Create new option, this setting displays the query for the saved search that is used for the backlog.

When done, click the Create Board button. The Board Settings page opens to the General tab.

Set Sprint Options

The General tab displays the settings that you just defined to create the board.

/help/img/youtrack/7.0/scrum_tutorial_sprint_options.png

This tab also lets you configure how you manage issues in sprints on the board.

OptionDescription
Manually assign issues to sprintsLeave this default option enabled if you want to manage which issues are added to the board explicitly. New issues that are created in your projects are not seen on the board unless you add them manually. When you use this option, you prioritize all of your work by grooming and refining issues in the backlog.
Add new issues to sprintFor Scrum development, you generally want to plan all of the work that you want to finish at the beginning of the sprint. This option adds any new issue that is created in your projects to the board automatically. This behavior defeats the purpose of spring planning and is not recommended for Scrum development.
Link sprints to custom fieldThis option synchronizes sprints with the values that are stored in a custom field. When enabled, issues are assigned to sprints automatically when you update the value that is set for the linked custom field. Use this option when you want to issues in each sprint to match the product iteration for which they were developed.

Define Columns and Swimlanes

The next step is to configure the settings that identify columns and rows on the board. When the board is created, the custom field that you configured in the first section of this tutorial is used to identify columns by default.

On the Columns and Rows tab, you can use the Add column option to add values from this field as columns to the board.

/help/img/youtrack/7.0/scrum_tutorial_columns.png

By default, the template for the Scrum board uses the Type field to identify swimlanes.

/help/img/youtrack/7.0/scrum_tutorial_swimlanes.png

For the development board, you show swimlanes for features or user stories. Each card on the board represents a task that contributes to the completion of the user story. When you create an additional board to track the development of the final product, you show swimlanes for epics. The cards on this board represent the user stories that you work on during each sprint.

Customize Card Presentation

The Cards tab gives you a few options that you can use to configure your Scrum board.

/help/img/youtrack/7.0/scrum_tutorial_cards.png

If you estimate the amount of time that is required to finish each task, you can display estimations on the board. Use the Estimation Field setting to select which field is used to store estimations in your projects. This lets you show and update estimations directly on each card.

You can also set the color scheme that is used to highlight cards on the board. There are two ways to color cards. The simple scenario is to color cards based on the value of an issue field, for example, Project or Priority. The Priority field has a default color scheme. Critical issues are highlighted in pink, normal issues in green. You can update the color scheme for custom fields on the Edit Project page.

/help/img/youtrack/7.0/kanban_tutorial_cards_priority.png

You can use this approach for any enumerated field.

If you color cards by project, you assign each a project a color on the Card tab of the Board Settings page.

A second approach is to color cards based on dynamic conditions, like an approaching deadline (the closer the deadline, the deeper the red color of the card). This scenario is described in the Workflow Tutorial. You can program your business logic with the Workflow Editor to change the color of each card automatically.

Configure the Chart

The Chart tab lets you choose which report you want to display on your Scrum board.

/help/img/youtrack/7.0/scrum_tutorial_chart_config.png

The Scrum development methodology uses a burndown chart. This report shows the ideal progress vs. actual progress for all of the issues that are assigned to the current sprint. The burndown chart helps you monitor your progress, analyze your development process, and measure the velocity of your team.

Use the Issue Filter setting to limit which cards are included in the calculation of the report.

You can calculate the burndown based on the number of issues that are resolved each day, the value that is stored in the estimation for the task, or the amount of work that is logged as a work item.

Working with the Scrum Board

When you have finished configuring the board, you and your team can use the board to manage your work. Here are some of the key components of the board with a few guidelines for using the board with the Scrum development framework.

Product Backlog

One of the key concepts in Scrum is to maintain a product backlog. The backlog contains an ordered list of requirements for delivering the final product. In general, the backlog determines which features will be delivered in the product and the order in which they will be built.

/help/img/youtrack/7.0/scrum_tutorial_backlog.png

You can open the backlog directly on the board. Here, the Product Owner can crag issues into the order that they will be assigned to sprints for development. Because the backlog is based on a saved search, you can also open the backlog in the issues list. Any change to the order on the issues list is updated on the board in real time.

/help/img/youtrack/7.0/scrum_tutorial_backlog_issues.png

Plan Your First Sprint

When you have collected all of the features or user stores that you want to develop and have prioritized these issues in the backlog, you are ready to plan and execute your first sprint.

Sprints usually start when the scrum team holds a planning event. During this event, the team identifies which user stories can be finished in the sprint. They then identify which tasks are required to deliver each user story, creating the sprint backlog.

You can use the agile board to facilitate this process. To create the sprint backlog, simply add issues as subtasks to the user stores in the backlog.

/help/img/youtrack/7.0/scrum_tutorial_scrum_planning.png

When you create your Scrum board, an unscheduled sprint is created by default. To schedule your first sprint, open the Sprints drop-down list and edit the sprint.

/help/img/youtrack/7.0/scrum_tutorial_edit_first_sprint.png

In the Edit Sprint dialog, describe the features that you want to deliver in this sprint as the sprint Goal. The sprint goal is displayed at the bottom of the board and is visible to the team for the duration of the sprint.

Next, open the calendar and set the schedule for the sprint.

/help/img/youtrack/7.0/scrum_tutorial_edit_sprint.png

Now you're ready to add issues to the sprint as swimlanes. You can drag issues from the backlog to the board, or use the Add swimlane to sprint option. This option lets you choose whether you want to add the subtasks from the sprint backlog to the board as well.

/help/img/youtrack/7.0/scrum_tutorial_add_swimlane.png

Daily Scrum

After you have defined the first sprint, the team can then use the board to track their efforts for the current sprint. A common practice in scrum teams is to participate in a daily scrum or stand-up. Any obstacle that impedes progress in the sprint can be identified and captured on the board as a new issue or bug.

/help/img/youtrack/7.0/scrum_tutorial_add_card.png

As your team completes each task, the cards move from the left side of the board to the right-most column that represents the end state.

If the team decides to abandon a task for whatever reason, you can remove it from the sprint. You can open the backlog and drag the card from the board to the backlog. Alternatively, select multiple cards and use an option in the footer to send the selected cards to the backlog.

/help/img/youtrack/7.0/scrum_tutorial_send_to_backlog.png

Card Size and TV Mode

The slider at the top of the board sets the level of detail for cards on the board. This setting is user-specific and can be set independently for different boards.

/help/img/youtrack/7.0/scrum_tutorial_card_size.png

Some teams use large monitors or projectors to display the board during the daily scrum. TV mode displays the board in full screen and uses a color scheme with a dark background. This visual presentation has been proven to improve visibility from a distance on large monitors.

Progress Indicators

The progress indicator shows the distribution of cards by state. Each bar corresponds to a column on the board.

To view the total number of cards in each column, move the pointer over the corresponding column in the progress indicator. The number of cards in each swimlane is displayed on the right side of the swimlane.

/help/img/youtrack/7.0/scrum_tutorial_progress_indicators.png

If you have enabled the Estimation Field setting, the board displays the total estimation for all of the cards at the top of the board. The presentation varies based on the data type of the custom field that is used to estimate the time that is required to complete a task.

This example shows estimations as a duration. The total estimation for all of the cards in each swimlane is displayed on the right side of the swimlane.

Tracking Your Progress

You can open the burndown chart directly on the board. The chart shows the ideal burndown that was calculated based on the number of tasks or total estimation at the beginning of the sprint. The remaining effort line represents the number of issues or total estimation for unresolved issues that are assigned to the sprint. Move the pointer over a date on the chart to compare the difference between these values and see whether you are ahead of or behind schedule.

/help/img/youtrack/7.0/scrum_tutorial_burndown_chart.png

Thee vertical axis represents the amount of effort remaining. The horizontal axis represents time by date. This chart shows estimations in ideal days. At the selected point in time, the project team is completing the tasks that were assigned to this sprint ahead of schedule.

Subsequent Sprints

When you finish your first sprint, the cycle continues. Teams usually hold a review and retrospective at the end of the sprint to revisit what was accomplished during the sprint and identify improvements for the next iteration.

The following sprint starts with another sprint planning event. When you have identified the user stories that you want to finish in the next sprint, open the Sprints drop-down list and select the New sprint option.

If you have any unresolved issues that were assigned to the previous sprint, you can move them to the new sprint automatically.

/help/img/youtrack/7.0/scrum_tutorial_next_sprint.png

And so it goes. As you continue developing new features, the product backlog dwindles. If you're staying on track and delivering on schedule, you end up with a final product version that you can release to your customers...

... and start working on the next version!

Last modified: 2 February 2017