Add New Issue Page

This page lets you create a new issue.

New issue details

Each issue is a record of a small-scale goal that someone perceives needs to be accomplished. The New issue details tab lets you enter the main information about the new issue that you are creating, including a brief summary and what the issue is about (the issue’s topic).

To create the new issue:
  • Enter the issue details, then click the Apply button.
To abandon the creation of the new issue:
  • Click the Cancel button.

Description of form fields

Issue summary

A short summary of the issue, which must not be left blank.

For consistency:

  • Keep the summary to a single sentence.

  • Don’t place a full-stop at the end.

  • Describe how things would be if the issue were to be resolved, rather than the current situation.

    For example, say ‘Product should not crash when started’ rather than ‘Product crashes when started’. Likewise, write ‘Latest financial report should be reviewed’ in preference to ‘Review latest financial report’.

Topic Describes what the issue is about. For more information, see the relevant glossary entry.
Reported in/

Displays the subtopic or version for the topic about which the issue has been reported. The adjacent Build entry field can hold any text and may be used to identify further the subtopic or version. For example, the build number of a software product might be entered here if the topic concerned a software product, or the printing of a book, if the topic represented one of a publishing company’s books.

Whether or not this field is present depends on the configuration of the issue’s topic.


This identifies what sort of issue is being recorded. The available types can be configured by the system administrator.

Examples of typical types include ‘Requirement’, ‘Risk’, ‘Defect Report’, ‘Enhancement Request’, ‘Helpdesk Ticket’, ‘Note for Future Review’, ‘Administrative Activity’, etc.


Indicates the importance of the issue to the person experiencing the problem (or making the request) that resulted in the issue being created. Note that this is for information only, and does not necessarily affect when a manager might schedule an issue to be resolved.

Detailed description (optional)

A full description of the issue.

The administrator of the system can provide a template description for each different type. Template descriptions can serve as a useful reminder of the information your organization wishes to record for particular types of issue.