Create and work with issues
An issue is the most basic entity in Jira Core. Depending on your team and its needs, issues can represent different things. In the Dragon Design Tees project example, each issue would represent the work needed to create and complete new t-shirt designs.
Create your first issue
Let's create an issue to track the creation of a new t-shirt design.
- Click in the sidebar
- Fill out the fields using the sample data is shown below (Only the fields with * are mandatory):
- Project: Dragon Design Tees
- Issue Type: Task
- Summary: Create a contractor resources spreadsheet
- Description: The spreadsheet must contain a breakdown of all contractors and specific skill sets.
- Leave all other fields blank or at their default values.
- Click Create
You can quickly add multiple issues to a project from the board. To do this, select + Create in the left-most board column, complete the summary and save. Note that if you have any mandatory fields for issues you create, clicking + Create will take you to the Create dialog.
A confirmation message will display for a few seconds. Make a note of the issue key of your new issue (DT-1, for example).
Create two more issues to familiarize yourself with the process. Select the Create another check-box at the bottom of the Create issue dialog to keep the dialog open after you click Create.
We've released a new issue view for Jira Core boards, and we've started to roll it out for the full-page issue view and project issue navigator. The issue detail view will look a little different, some procedures will change slightly, and we have a new editor with markdown support. Take a look at our info page to see what's changed and get the latest updates.
Edit an issue
You can edit your issue to add more information, attach new files or screenshots, and add metadata like labels. Inline editing is the quickest way to edit an issue. To access all issue fields, including blank fields that don't appear when inline editing, you can use the Edit issue dialog.
- In your project, select Issues from the project sidebar and open the first issue you created.
- Hover over the Priority field. Click to edit the field.
- Change the Priority to "Critical" and click anywhere outside the field to save your change.
The issue is updated immediately. Now, let's see how to start working on an issue.
Progressing the issue
Every issue has a lifecycle. In Jira Core, the lifecycle of an issue is managed by a workflow. A workflow consists of the issue statuses, like To Do, and the transitions between each status (Start progress, for example). In this step, you'll start working on your issue by transitioning it from To Do to In Progress.
- Open the first issue you created (DT-1)
The issue should be in the To Do status.
- Select Start Progress or click the current status
The status of your issue will be changed to In Progress.
You can then choose to stop progress, or close the issue by marking it as "Done" and selecting a resolution.
Notice that resolving an issue prompts you to enter more information, whereas starting progress on the issue didn't. Some issue transitions have screens associated with them in the workflow associated with your project. Remember, a project can only have one workflow associated with it.
Assign the issue to another user
You can better manage your work by assigning issues to other members of your team.
- Open one of the issues you have created
- Choose Assign on the issue
- Type emma in the Assignee field and select her as the assignee from the drop-down list that appears
- Type (don't copy and paste) the following text in the Comment field and choose Assign
Hi @emma, I've assigned this issue to you to work on this week.
A few things when you enter the comment:
- When you start typing after the @ symbol, you're prompted to choose a user—Emma, in this example. Emma will be sent an email notification, which links to the issue, when you save. This feature is called mentioning a user.
- On choosing Assign:
- The issue is assigned to Emma with a comment added to it.
- A link is automatically created to the issue in the issue comment.
Jira Core ships with default workflows. The workflows can be changed and customized, but this can only be done by an Administrator.
Awesome! You've created some issues, edited one, and assigned another to a member of your team. You're really getting the hang of working with issues. Now, you'll learn how to best search for the issues you need to work on.