Issue log


An issue log is a documentation element of software project management that contains a list of ongoing and closed issues of the project. While issue logs can be viewed as a way to track errors in the project, the role it plays often extends further. Issue logs can be used to order and organize the current issues by type and severity in order to prioritize issues associated with the current milestone or iteration. Issue logs may also contain customer requests and remarks about the various problems that can be found in current code.
CAIR - Constraints, Assumptions/Actions, Issues, Risks - a log for tracking such items and managing them.

Issue management

An issue log is usually blank at the beginning of the project, but this is not always true for subsequent releases. In some projects, the issue log is actually used as a guideline for the release schedule; in that case the issue log can be populated with issues that are specifically tagged for completion in the upcoming release. As a result, issue log-guided projects may be easier to manage in terms of completion time and progress estimation.

In large projects, issues are usually managed by issue tracking software that can provide different ways and tools to help the project manager and the development team handle thousands of issues for one or several of their projects. Some issue tracking systems also provide a way for the community to contribute new ideas and/or code to the project; this type of collaboration is widely used in open source programming.

Release issues / known issues

In a case when the project issues can not be fully resolved, a known issues document is supplied with the software. That document contains a list of issues that are known to exist and, in some cases, instructions on how to overcome the problems caused by these issues.

Template

In a typical issue log, the document must be a table containing multiple rows in which each row describes a separate issue. The various attributes of the issue are listed in different columns. An example of a typical issue log is shown below.

Basic issue information

Issue IDIssue nameDescriptionIssue authorPartiesTypeprioritySeverityDate raisedDate assignedDeadlineDate resolvedstatusActionsResolutionNotes
0001Sample Issue1Sample DescriptionMr.AMr.A,B; Mrs.CIT ApplicationHighCritical20091010200910112010010120091015ResolvedSome ActionsResolutionsThings to do
0002Sample Issue2Sample Description......------------

The documentation style of an issue log may differ from project to project. Some of attributes listed above may be considered unimportant to record, while other additional attributes may be necessary. However, main attributes such as description, author, priority, status, and resolution should always be included. Further, the sequence of attributes may differ as well.