Stories Pane
Introduction
For version control enabled apps (apps with Team Server or other SVN servers), the Stories pane displays the stories and tasks of the current Sprint. Stories, tasks, and Sprints are created and managed via Stories or Epics in Apps.
In the Stories pane, you can view the stories and tasks of the current Sprint, show or hide done stories, open their details, change the status of the stories and tasks, and open documents connected to stories.
If you use Stories, both stories and tasks of the current Sprint are shown in the Stories pane.
If you use Epics, only the stories of the current Sprint will be shown in the Stories pane; the tasks of each story will not be shown. You also cannot change the status of the stories in the Stories pane.
The Stories pane consists of the top bar with various buttons and a table:
The table contains following columns:
- Story – shows a list of stories
- Tasks are displayed as a sub-list of the corresponding story
- Status – shows the status of a story or a task
Interacting with the Stories Pane
You can perform the following actions in the Stories pane:
- Refresh the Stories pane
- View stories details
- Show or hide completed stories
- Open documents connected to stories
- Change the status of a story or a task
Refreshing the Stories Pane
The Refresh button allows you to get the latest changes on stories and tasks done by you and your team members in Apps or Studio Pro.
If two team members change the same story, the changes done last will take effect. For example, you set the story status to Running, but your colleague sets it to Done two minutes later. The story’s status will be set to Done when you click Refresh, as your colleague was the last one to implement changes.
Viewing Details
To view details of a story, do one of the following:
- Double-click it in the table
- Select the story in the table and click the Details button in the top bar
A plus icon next to a story means it has tasks assigned to it. To view details of a task, click the plus icon and do one of the following:
- Double-click the task in the table
- Select the task in the table and click the Details button in the top bar
When you view the details of a story or task, the Story Details pop-up window is opened with the following information:
-
Title – the title of the story/task
-
Status – the current status of the story/task
-
Story points – the story points assigned to the story/task
-
Description – the description of the story/task
Showing Completed Stories
When enabled, the Show complete stories button allows you to show the stories that are set to Done. For more information on statuses of stories, see the Changing the Status of a Story or a Task section below.
Opening Documents Connected to Stories
If the story is created from a feedback item, you can open a document which the feedback item refers to. That means if a feedback was submitted for a widget on a page, the Open document button or icon will open this page.
To open the document, either click the Open document button in the top bar or the corresponding icon in the table:
For more information on how to create a story on the basis of a feedback item and add it to your board in Epics or Jira, see the Feedback Details section in Feedback.
Changing the Status of a Story or a Task
If you use Epics, you cannot change the status of the stories in the pane.
To change the status of a story, click its status in the Status column. The status will change in the following succession: To do > Running > Done > To do.
To change the status of a task, tick or clear the checkbox in the Status column:
- Clear the checkbox to set the done task in To do
- Tick the checkbox to set the task to Done