This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
map_suite_jira_guide [2017/04/26 20:14] benbai [Log work] |
map_suite_jira_guide [2017/04/28 03:27] (current) marklee [Create a New Issue Screen] |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Map Suite JIRA Guide ====== | ====== Map Suite JIRA Guide ====== | ||
- | This guide shows how to manage Map Suite projects and issues in Jira. [[https://thinkgeo.atlassian.net|ThinkGeo Jira]] also has Curtus View projects on it, and this guide only cares about Map Suite Projects and issues. | + | This guide shows how to manage Map Suite projects and issues in JIRA. [[https://thinkgeo.atlassian.net|ThinkGeo JIRA]] also has Curtus View projects on it, and this guide only cares about Map Suite Projects and issues. |
===== Project Types / Categories ===== | ===== Project Types / Categories ===== | ||
- | This section introduces how the Map Suite projects are organized. | ||
- | |||
After signing in [[https://thinkgeo.atlassian.net|ThinkGeo JIRA]], goto Projects/View all projects and you will see all the projects and categories. | After signing in [[https://thinkgeo.atlassian.net|ThinkGeo JIRA]], goto Projects/View all projects and you will see all the projects and categories. | ||
Line 11: | Line 9: | ||
* **//Project type / Business//** None of the projects are under this group so far; | * **//Project type / Business//** None of the projects are under this group so far; | ||
- | Categories: (I renamed it to Map Suite Products from ThinkGeo Products, please update the snapshot accordingly. ) | + | Categories: |
* **Map Suite Products: ** Map Suite products line, including iOS, Android, GIS Server etc. | * **Map Suite Products: ** Map Suite products line, including iOS, Android, GIS Server etc. | ||
* **ThinkGeo Internal Projects: ** The internal projects, like single point, demo etc. | * **ThinkGeo Internal Projects: ** The internal projects, like single point, demo etc. | ||
Line 18: | Line 16: | ||
{{:jira_projects.png? |}} | {{:jira_projects.png? |}} | ||
- | ===== When to create a new project===== | + | ===== Create a project===== |
- | We don't create a new project very often. Please let Howard, Johnny or Mark to do it if you want to create a new Project. | + | We don't create a new project very often. Please let Howard, Johnny or Mark do it if you want to create a new one. They know how to set up the correct workflow/issue screen schema to the project. |
- | ===== Create a new issue ===== | + | ===== Create an issue ===== |
- | ====When to Create a new issue ==== | + | ====New Issue Screen==== |
Everyone working on Map Suite needs to create a new task if either of the following requirement is met: | Everyone working on Map Suite needs to create a new task if either of the following requirement is met: | ||
Line 40: | Line 38: | ||
* //Bug:// Problem that impairs product or service | * //Bug:// Problem that impairs product or service | ||
* //Improvement:// Enhancement for product or service | * //Improvement:// Enhancement for product or service | ||
- | * //Story:// Functionality request expressed from the perspective of the user | ||
* //Sub-Task:// Smaller task within a larger piece of work | * //Sub-Task:// Smaller task within a larger piece of work | ||
- | * //Epic:// Large piece of work that encompasses many. We don't need to have it for most cases. | + | * //Story:// Functionality request expressed from the perspective of the user |
- | (Story kind of overlaps with Task/Bug/Improvement. Story is more from user's perspective but Task/Bug/Improvement is from developer's perspective.) | + | * //Epic:// Large piece of work that encompasses many. We don't need to have it for most cases. |
+ | |||
+ | * Note 1: Story overlaps with Task/Bug/Improvement a little bit. Story is more from user's perspective but Task/Bug/Improvement is from developer's perspective. | ||
+ | * Note 2: Most likely, A story will be specified by different Task/Bug/Improvement, in this case we want to hook up those Task/Bug/Improvement with that story by using linked issues. | ||
+ | |||
* **Summary:** It is the major title of this issue and try to best to simplify your sentence and cover the issue point. | * **Summary:** It is the major title of this issue and try to best to simplify your sentence and cover the issue point. | ||
+ | * Fix one bug, set JIRA’s title **Fixed XXX**; | ||
+ | * Improve products, set JIRA’s title **Improved XXX**; | ||
+ | * New feature, set JIRA’s title **Supports XXX**. | ||
+ | |||
* **Description:** Should have more details for your issue, including following items. The more the better. | * **Description:** Should have more details for your issue, including following items. The more the better. | ||
* Where it comes from | * Where it comes from | ||
Line 50: | Line 56: | ||
* What causes it if you know | * What causes it if you know | ||
* The solution you expected | * The solution you expected | ||
- | * **Priority:** If you don't know, just leave it default. But if it is not urgent, please use Trivial. | + | * **Priority:** It has 4 levels, Blocker, Critical, Major and Minor. We don't use Blocker unless it's serious important. Leave it as default priority if you are not sure when creating a ticket. |
* **Attachment:** If you have a sample to recreate the issue or a prototype for your idea, please attach it here. | * **Attachment:** If you have a sample to recreate the issue or a prototype for your idea, please attach it here. | ||
* **Assignee:** If you don't know who is the resource, just leave it unassigned. | * **Assignee:** If you don't know who is the resource, just leave it unassigned. | ||
- | Then click Create button and the task is created. | + | Fill the other fields if needed, then click Create button to create the issue. |
====Issue Work Flow==== | ====Issue Work Flow==== | ||
Line 84: | Line 90: | ||
- | ===== Estimate issues ===== | + | ===== Track an issue ===== |
- | Before a sprint starts, you need to enter the Original Estimates of your issues. And as you work on the issues during the sprint, you need to adjust the Remaining Estimates as necessary. | + | ====Create an Original Estimate==== |
+ | Before moving an issue to TODO list, you need to enter the Original Estimates. And as you work on it, you need to adjust the Remaining Estimates as necessary. | ||
- Navigate to the Backlog of your desired board. | - Navigate to the Backlog of your desired board. | ||
- Click the issue that you want to set the Original Estimate for. | - Click the issue that you want to set the Original Estimate for. | ||
- In the Issue Detail View, type your estimate in the Estimate field. | - In the Issue Detail View, type your estimate in the Estimate field. | ||
- | |||
{{:jira_estimate.png |}} | {{:jira_estimate.png |}} | ||
- | ===== Summary ===== | + | ==== Log the Hours ==== |
- | As we are going to use JIRA for all the issues, we must follow this workflow when using JIRA. | + | Once have started working on a specific issue, you need to log your hours everyday if there is any update. |
+ | - Select the issue you want to log time on. | ||
+ | - Go to More > Log Work. | ||
+ | - Fill in the following Log Work fields, and select Log. | ||
+ | {{:jira_log_work.png |}} | ||
+ |