Jira Concepts - Issues

Jira tracks issues, which can be bugs, feature requests, or any other tasks you want to track.

Each issue has a variety of associated information including:

  • the issue type
  • a summary
  • a description of the issue
  • the project which the issue belongs to
  • components within a project which are associated with this issue
  • versions of the project which are affected by this issue
  • versions of the project which will resolve the issue
  • the environment in which it occurs
  • a priority for being fixed
  • an assigned developer to work on the task
  • a reporter - the user who entered the issue into the system
  • the current status of the issue
  • a full history log of all field changes that have occurred
  • a comment trail added by users
  • if the issue is resolved - the resolution

Issue Types

Jira can be used to track many different types of issues. The currently defined issue types are listed below. In addition, you can add more in the administration section.

For Regular Issues
Change
Created by JIRA Service Desk.
IT Help
For general IT problems and questions. Created by JIRA Service Desk.
Service Request with Approvals
For requests that require approval. Created by JIRA Service Desk
Improvement
An improvement or enhancement to an existing feature or task.
Problem
Track underlying causes of incidents. Created by JIRA Service Desk.
Task
A task that needs to be done.
Bug
A problem which impairs or prevents the functions of the product.
New Feature
A new feature of the product, which has yet to be developed.
Incident
For system outages or incidents. Created by JIRA Service Desk.
Service Request
Created by JIRA Service Desk.
Hosted Website Requests
This issue type is to facilitate the requests for URL's to webmaster.
PSS Issue
Epic
Created by Jira Software - do not edit or delete. Issue type for a big user story that needs to be broken down.
Project Proposal
This is to capture and hash out project ideas before they move to being a Project Scope Statement.
Story
Created by Jira Software - do not edit or delete. Issue type for a user story.
Change Request
A request for a change that is more than a simple Technical Correction to one of HL7's specifications
Open Issue
Indicates a problem with a specification that needs to be addressed but does not propose a solution
Ballot Submission
A user's submission in response to a formal ballot by HL7 on a specification
Question
A request for an answer that doesn't anticipate any update of the specification as a result. Consider using https://stackoverflow.com/questions/tagged/hl7_fhir or http://chat.fhir.org instead.
Comment
Feedback about a specification that doesn't anticipate any change or other action as a result. Consider using http://chat.fhir.org instead.
Technical Correction
A non-substantive change to correct an obvious error with a non-debatable solution. E.g. Correcting a typo, grammar issue, formatting problem, broken tool function, incorrectly coded formal constraint, etc.
Ballot Definition
A ballot that HL7 will be performing against a specification
Change Proposal
Maintenance
This issue type is used to set the VoC voting parameters. Adjustments to this issue type will affect how voting is handled in VoC
User Registration
A request for a new Jira/Confluence user account
Project Scope Statement
A Projcet Scope Statement Submission
For Sub-Task Issues
Sub-task
The sub-task of the issue
Ballot Vote
The designation of a comment about a specification as related to an overall Ballot Submission
PSS Approval

Priority Levels

An issue has a priority level which indicates its importance. The currently defined priorities are listed below. In addition, you can add more priority levels in the administration section.

Highest
This problem will block progress.
Very High
Very High
High
Serious problem that could block progress.
Medium
Has the potential to affect progress.
Low
Minor problem or easily worked around.
Very Low
Very Low
Lowest
Trivial problem with little or no impact on progress.

Statuses

Status Categories

Helps identify where an issue is in its lifecycle.
Issues move from To Do to In Progress when work starts on them, and later move to Done when all work is complete.

Done

Represents anything for which work has been completed

In Progress

Represents anything in the process of being worked on

No Category

A category is yet to be set for this status

To Do

Represents anything new

Issue Statuses

Each issue has a status, which indicates the stage of the issue. In the default workflow, issues start as being Open, progressing to In Progress, Resolved and then Closed. Other workflows may have other status transitions.

Review
The issue is open and ready for the assignee to start work on it.
WG Approval
This issue is being actively worked on at the moment by the assignee.
Reopened
This issue was once resolved, but the resolution was deemed incorrect. From here issues are either marked assigned or resolved.
Changes Published
Force the generation of a new publication with all rendered web pages of content out of the Git Master
Assigned
Proposal has been moved to fully approved and ready to be queued for implementation, bypassing Consensus step.
TSC Exec
Done
Co Sponsor Workgroup Approval
Submitted
Change has been proposed but has not yet been reviewed
Triaged
An change proposal has been fully categorized and is ready to be actioned
Resolved - change required
There is agreement that a change of some sort needs to be made in response to the requested change
Resolved - No Change
Decision has been reached that no change will be made to the specification based on the requested change
Waiting for Input
The change proposal is on hold while awaiting input from an individual or group
Duplicate
The change request has been identified as a duplicate of an existing change request. No further action will be taken on this change request
Applied
All of the agreed changes have been applied to the specification
Published
An official version containing the requested change has been released
Declined
This was auto-generated by JIRA Service Desk during workflow import
Waiting for support
This was auto-generated by JIRA Service Desk during workflow import
Waiting for customer
This was auto-generated by JIRA Service Desk during workflow import
Auto Validation
Submit to tooling plugins for autovalidation of proposal as submitted.
Canceled
This was auto-generated by JIRA Service Desk during workflow import
Escalated
This was auto-generated by JIRA Service Desk during workflow import
Waiting for approval
This was auto-generated by JIRA Service Desk during workflow import
Lock for validation
Submitted proposal is locked and queued for two-step validation process.
Edit Proposal
This was auto-generated by JIRA Service Desk during workflow import
Awaiting implementation
This was auto-generated by JIRA Service Desk during workflow import
Implementing
Use tooling to implement the change to the UTG SoT, and publish new versions of changed objects. Perform release operations for proposal changes, final QA, approval, notification of new release availability. Mark proposal as complete.
Receive proposal from other project
Receive proposals from other project workflow, either consensus approved, or technical corrections or QA fixes. Maybe a listener?
Work in progress
This was auto-generated by JIRA Service Desk during workflow import
Completed
This was auto-generated by JIRA Service Desk during workflow import
Under investigation
This was auto-generated by JIRA Service Desk during workflow import
Final Review
This was auto-generated by JIRA Service Desk during workflow import
Draft
Proposal is being worked on, not yet finished being edited and error-checked.
Content Check
Proposal has passed auto checks and auto triage, is queued for manual QA.
consensus review
Enter consensus review state, out for peer review. Transfer ticket to peer review workflow.
Withdrawn
Proposal has accepted the disposition and withdraws their negative
Queued for Implementation
Proposal has been queued for implementation.
Change Rejected
Change has been rejected by community or management.
Meeting Needed
The consensus was controversial, and a meeting is needed to achieve a decision on proposal.
Us Realm
This was auto-generated by JIRA Service Desk during workflow import
Closed
This was auto-generated by JIRA Service Desk during workflow import
Awaiting CAB approval
This was auto-generated by JIRA Service Desk during workflow import
FHIR Management Group Review
This is a stage for FHIR MG to review and approve a PSS.
Peer review / change manager approval
This was auto-generated by JIRA Service Desk during workflow import
Balloted
A ballot has been submitted and is ready to be reconciled
Deferred
The proposal will not be considered as part of the current release. It will be re-activated and reviewed as part of the next release cycle
Waiting for answer
Some problem or question has arisen in processing the proposal, and it is in a waiting state until the problem or question is resolved.
Sent For Implementation
Pass an approved proposal to the curation staff for implementation and publishing of the changes.
Environment Setup
View Help screens, download and install local tools, etc.
Retracted
An initial request by the submitter has been cancelled prior to any action being taken
Cancelled
Rejected
pending
This was auto-generated by JIRA Service Desk during workflow import
CDA Management Group Review
This is the phase for CDA MG Review and approval
V2 Management Group Review
This is the phase when V2 MG reviews and approves a PSS.
Multi Family Review
This is for the review and approval of multiple family groups.
ARB and Steering Division
Steering Division
In Progress
This issue is being actively worked on at the moment by the assignee.
Ready for Review
Administrative Review
Steering Division Review
TSC Review
Conflicted
In Review
Open
The issue is open and ready for the assignee to start work on it.
Passed
Planning
This was auto-generated by JIRA Service Desk during workflow import
Proposal Draft
Change proposal is in DRAFT state being worked on prior to submitting for validation and consensus.
Proposal Implemented
Proposal has been implemented in the source of truth repository, and is complete. Changes available in GitHUB.
Under review
This was auto-generated by JIRA Service Desk during workflow import
review 2
Opt-Out
This group has chosen NOT to review
PSS Rejected
Updated BitBucket Master
We have updated the BitBucket Master with the changes in the branch for this proposal
Publish-Release Operations
Do the admin operations around generation and publishing of releases
Changes Implemented
A resolution has been taken, and it is awaiting verification by reporter. From here issues are either reopened, or are closed.
Triage
This still to be determined who will actually triage.
WG Final Check

Resolutions

An issue can be resolved in many ways, only one of them being "Fixed". The defined resolutions are listed below. You can add more in the administration section.

Done
Work has been completed on this issue.
Won't Do
This issue won't be actioned.
Duplicate
The problem is a duplicate of an existing issue. Check the resolution of the linked issue.
Cannot Reproduce
All attempts at reproducing this issue failed, or not enough information was available to reproduce the issue. Reading the code produces no clues as to why this behavior would occur. If more information appears later, please reopen the issue.
Declined
This issue was not approved.
Considered - No action required
Generally a response to a Comment where there is no expectation of a change being considered
Considered - Question answered
An answer has been provided to the question, but no change has been made to the specification
Considered for Future Use
The proposed change will not be made now, but the issue will be reopened and re-considered as part of the next release
Not Persuasive with Modification
The proposed change will not be made, however a change will be made to the specification that may improve clarity or address the root cause of the proposal
Not Related
The proposal applies to content that is outside the scope of the specification the comment it was submitted against. The proposal might be considered if re-submitted against the appropriate specification
Persuasive
The proposed change will be made as suggested
Persuasive with Modification
The proposed change will be made in spirit, but with minor adjustments to reflect committee agreement
Not Persuasive
Not Persuasive
Retracted
Submitter has resolved the issue on their own/determined no issue should have been raised. No action is needed