An issue log is a documentation element of

software project management Software project management is an art and science of planning and leading software projects. It is a sub-discipline of project management in which software projects are planned, implemented, monitored and controlled. History In the 1970s and 1 ...

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 A milestone is a numbered marker placed on a route such as a road, railway line, canal or boundary. They can indicate the distance to towns, cities, and other places or landmarks; or they can give their position on the route relative to so ...

iteration Iteration is the repetition of a process in order to generate a (possibly unbounded) sequence of outcomes. Each repetition of the process is a single iteration, and the outcome of each iteration is then the starting point of the next 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 Estimation (or estimating) is the process of finding an estimate or approximation, which is a value that is usable for some purpose even if input data may be incomplete, uncertain, or unstable. The value is nonetheless usable because it is de ...

.
In large projects, issues are usually managed by issue tracking software that can provide different ways and tools to help the

project manager A project manager is a professional in the field of project management. Project managers have the responsibility of the planning, procurement and execution of a project, in any undertaking that has a defined scope, defined start and a defined ...

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 Open-source software (OSS) is computer software that is released under a license in which the copyright holder grants users the rights to use, study, change, and distribute the software and its source code to anyone and for any purpose. Open ...

Release issues / known issues

In a case when the project issues can not be fully resolved (such as in pre-release development stages), 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 reference number (ID): Typical number to identify different issues. *Issue name: Issue’s name. *Description: Briefly describe what the issue concerns. *Issue author: The person who raise this issue. *Parties: all the people involved in solving the issue.

Issue categories

*Issue type: what knowledge domain the issue belongs to. (E.g. IT infrastructure, IT application, etc.) *Issue priority: it determines which issue is the most urgent and should be solved first. (E.g. the priorities may encompass Immediate, Soon, Later, etc.) *Issue severity: how bad the consequence would be if the issue is left unsolved. (E.g. the severity may encompass Vital, Major, Medium, Minor, etc.)

Issue date information

*Date raised: when the issue is raised. *Date assigned: when the issue is assigned. *

Deadline Deadline(s) or The Deadline(s) may refer to: * Time limit, a narrow field of time by which an objective must be accomplished Arts, entertainment, and media Comics * Deadline (DC Comics), a fictional villain * ''Deadline'' (magazine), a British ...

: when is the final date to get the issue settled. *Date resolved: when the issue is actually solved.

Issue status

*Current status: the current status the issue is within. (e.g. investigating, escalated, resolved, etc.) *Actions updating: Actions performed before issue is resolved (List all the actions according to dates.) *Resolution: The final resolution to settle the issue.

Other Information

*Notes: Some ideas or things to remember. 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.

References

External links

ePMbook by Simon Wallace : Issues
* Software Project Management in Practice by Pankaj Jalote