Documenting JIRA Ticket Progress

Before starting on doing the work detailed in a ticket it should first be marked as in progress. If you are not already assigned to the Task then you should also ensure you are the assignee.

All work done on the task and time taken should be filled in on the Work Log associated with the ticket. This should be completed after each period of work to act as a a progress report should not just be done at the end of working on a task. It should give sufficient details that all team members can see what was done and why if there is a particular reason for some process. 

Open

On a completed task the work log should be providing a clear indication of what has been done on a given task and how long it has taken. In the case of bug fixes there should be a clear explanation of cause and fix so that it can act as a reference if similar issues arise again. On system updates changes ideally the commands used should be included as a reference of how the changes were made should the task need to be repeated.

The comment fields should be used to clarify the task if required and add extra information and notes. It may also have a summary comment added when a task is completed. If the details provided are not sufficient to carry out the task then this should be raised directly with the creator and the description updated and comments added to expand the requirements sufficiently so it is clear exactly what the ticket is referring to. 

As the Ticket is progressed the different stages of the work flow should be used appropriately. Each project can have a different workflow and it is important that the ticket status reflects correctly where a ticket is at. If tickets are waiting on another team member  then they should be assigned to the ticket with a comment indicating what is required. If code is in code review assign to the code reviewer with a comment "Please review the code and let me know if all is OK" for instance.

If the work flow doesn't have a suitable state to cover the current status then a modification of the work flow should be considered to ensure the tickets can fully capture the progress.