Volume Graphics (2006), T. Möller, R. Machiraju, T. Ertl ...
Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs,...
Transcript of Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs,...
![Page 1: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/1.jpg)
Begin planning with JIRA
- EPICs, Stories, Subtasks
Jan-Simon Möller
training.linuxfoundation.org
![Page 2: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/2.jpg)
Topics
• Basic Rules
• What are EPICs, (User-)Stories, Sub-Tasks
• Guidelines, Best Practices
• How to create EPICs, Stories, Sub-Tasks
• How to enter the data for the upcoming release
![Page 3: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/3.jpg)
Basic rules
![Page 4: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/4.jpg)
Basic rules
• Use JIRA as the only place to plan the project work.
→ It will make it transparent to all participants
→ In your project, but also to related projects
→ Progress and backlog allows coordination
![Page 5: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/5.jpg)
Basic rules
• Use same JIRA issue types across all projects;
• OPNFV uses :
– Epic– Story– Subtask– Bug
![Page 6: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/6.jpg)
Basic rules
• Use Stories for planning the work items
→ Coordination with fellow projects
→ Define relationships (depends/blocks)
![Page 7: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/7.jpg)
Basic rules
• Define clear Acceptance Criteria / Definition of Done
– e.g. list of activities that add verifiable/demonstrable value to the product
• written code• code comments• unit tests, integration tests• release notes• design documents• etc.
![Page 8: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/8.jpg)
What are EPICs, (User-)Stories, Sub-Tasks(OPNFV style)
![Page 9: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/9.jpg)
EPICs, Story, Sub-Tasks
• Agile Development / Scrum
• Issue Types
• Different abstraction levels
• Used to compose the Backlog of the development cycle
![Page 10: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/10.jpg)
EPICs
• >> 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. <<
• big, coarse-grained
• large themes, overall goals
![Page 11: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/11.jpg)
User Story
• >> A story or user story is a software system requirement that is expressed in a few short sentences, ideally using nontechnical language. <<
• Non-technical language, expresses user needs
• „As a <user> = who
I want to <be able to do XYZ> = what
so that <ABC can be done>“ = why
![Page 12: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/12.jpg)
Subtask
• >> A subtask issue is typically one of many tasks that make up a story . <<
• Contains description of individual work item (detailed , technical)
• Breaks-up stories into digestable workloads
• Can be shared, assigned, relate to, depends/depended on by, blocks/blocked by
![Page 13: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/13.jpg)
Guidelines, Best Practices
![Page 14: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/14.jpg)
Guidelines, Best Practices (0)
• Check for existing issues first
– check the project - the issue might exists already– avoid duplicates !
![Page 15: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/15.jpg)
Guidelines, Best Practices (1)
• Write good
– subject– description– definition of done (acceptance criteria)
→ Makes it easier to understand work items
→ Makes it easier to align/share work items
![Page 16: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/16.jpg)
Guidelines, Best Practices (2)
• Label stories in order to query backlogs easily.
– OPNFV uses the label R2for the Brahmaputra Release
– Use this label !
→ Makes it easier to query the backlog
→ Keeps track of the workload per release
![Page 17: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/17.jpg)
Guidelines, Best Practices (3)
• Properly progress work items
– Open → In Progress → Resolved → Closed
→ Gives fair view of what is happening
→ Allows estimate of remaining work / time
![Page 18: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/18.jpg)
Guidelines, Best Practices (4)
• Keep the work item specific conversations on JIRA.
– Do not copy to Wiki or Etherpad– use links to JIRA
→ Fellow projects can join the conversation
→ Single place to track
→ Decisions, Problems, Solutions documented
![Page 19: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/19.jpg)
How to create EPICs, Stories, Subtasks
![Page 20: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/20.jpg)
How to create an EPIC
• Log in to JIRA
•
• The „Create Issue“ form appears
![Page 21: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/21.jpg)
How to create an EPIC
• Select the Project
– e.g. SANDBOX
• Select the Issue type
– EPIC
• Short Name
– e.g. „OPNFV Tutorials“
• Summary
– e.g. „OPNFV Tutorial series about developer tools“
![Page 22: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/22.jpg)
How to create an EPIC
• Add Description
state:
– Development goal– Requirements– Definition of Done
![Page 23: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/23.jpg)
How to create an EPIC
• Add Attachments
• Add Labels
– e.g. R2(for Brahmaputra)
• Click on „Create“
![Page 24: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/24.jpg)
How to create a Story
• Log in to JIRA
•
• The „Create Issue“ form appears
![Page 25: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/25.jpg)
How to create a Story
• Select the Project
– e.g. SANDBOX
• Select the Issue type
– Story
• Summary
– e.g. „Tutorial about EPICs/Stories/Subtasks in JIRA“
![Page 26: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/26.jpg)
How to create a Story
• Add Description
state:
– Task goal– Definition of Done
As a user …
I want to …
So that ...
![Page 27: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/27.jpg)
How to create a Story
• Add Attachments
• Add Labels
– e.g. R2(for Brahmaputra)
• Link to EPIC
– „OPNFV Tutorials“– Use Drop-Down– Or just start typing
• OPNFV Tutorialor
• SANDBOX-3
• Click on „Create“
![Page 28: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/28.jpg)
How to create a Sub-Task
• Log in to JIRA
• To create a Sub-Task for a story first open the story within JIRA.
![Page 29: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/29.jpg)
How to create a Sub-Task
• To create a Subtask for a story first open the story within JIRA.
• Click on „More“
• Select „Create Sub-Task“
• A new form will appear
![Page 30: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/30.jpg)
How to create a Sub-Task
• Write the Summary
![Page 31: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/31.jpg)
How to create a Sub-Task
• Add the Description
![Page 32: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/32.jpg)
How to create a Sub-Task
• Add Attachments
• Add Labels: e.g. „R2“
• Click on „Create“
![Page 33: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/33.jpg)
How to enter the data for the upcoming release
![Page 34: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/34.jpg)
Typical workflow for planning
• Create project high level plan using EPICs
– As a project/team, start writing high level Epics in order to plan your work/deliverables
– Epics help you to group related stories under them to improve the visibility and traceability.
– Epics can also be used to give a high level roadmap regarding your project.
![Page 35: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/35.jpg)
Typical workflow for planning
• Write your user stories and plan your work
– Write good subject, description and definition of done/acceptance criteria
– Write user stories from user perspective
– „As a user, I want to … , so that … “
![Page 36: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/36.jpg)
Typical workflow for planning
• Label the stories that are in scope of the release
– Use R2 for Brahmaputra
![Page 37: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/37.jpg)
Typical workflow for planning
• Highlight the dependencies between Epics and/or Stories
– show what dependencies you have within your project
– Use JIRA Link feature to create associations
![Page 38: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/38.jpg)
Typical workflow for planning
• Highlight the dependencies between your Epics and/or Stories and other projects.
– Important – shows external dependencies– Use JIRA Link feature to create associations
![Page 39: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/39.jpg)
Typical workflow for planning
• Priorize the EPICs/Stories/Sub-Tasks
– Project priorities are visible to other Projects which might depend on it
– Available levels:• Blocker - e.g. blocks development, test, production• Critical - e.g. crash, loss od data, memory leak• Major - e.g. Major loss of function• Minor - e.g. Minor loss of function • Trivial - e.g. Cosmetic problem or spelling
![Page 40: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/40.jpg)
Typical workflow for planning
• Done
• Backlog ready and you can start to develop
• Regardless which workflow your project uses (this is up to the projects),
track progress in JIRA!
![Page 41: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/41.jpg)
Live Demo
![Page 42: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/42.jpg)
Task
• Create an EPIC in the SANDBOX project
• Create a Story in the SANDBOX project as part of your just created EPIC.
• Create two Sub-Tasks to your Story. Make one Sub-Task depend on the other.
![Page 43: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/43.jpg)
References
• https://help.rallydev.com/writing-great-user-story
• http://www.romanpichler.com/blog/10-tips-writing-good-user-stories/
• https://www.scrumalliance.org/community/articles/2008/september/what-is-definition-of-done-(dod)
• https://confluence.atlassian.com/display/AGILE/Product+Backlog
• https://confluence.atlassian.com/display/AGILE/Creating+an+Epic
• https://confluence.atlassian.com/display/AGILE/Story
![Page 44: Jan-Simon Möller training.linuxfoundation · 2015-09-18 · Begin planning with JIRA - EPICs, Stories, Subtasks Jan-Simon Möller training.linuxfoundation.org](https://reader034.fdocuments.in/reader034/viewer/2022042305/5ed0c2befb805320854bedbf/html5/thumbnails/44.jpg)
End
11.09.15