Add Issue To Milestone Page

This page lets you add issues to a milestone.

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/
Build

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.

Type

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.

Severity

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.

Add by issue id

This tab lets you add issues to the milestone by their issue id.

The Add from search and Add from advanced search tabs let you perform a search of issues via their summary, description and comment history.

To add issues to the milestone:
  • Enter a comma-separated list of issue ids in the Issue ids text field.
  • Click the Add button.
To abandon the addition of issues to the milestone:
  • Click the Cancel button.

Description of form field

Issue ids A comma-separated list of issue ids to add to the milestone.

Add from search

This tab lets you add issues to the milestone, by searching for issues via their summary, description and comment histories.

The Add from advanced search tab let you perform a search limited to a specific topic. The Add by issue id tab lets you add issues to the milestone by their ids.

To search for issues to add to the milestone:
  • Enter the text that may appear in an issue’s summary, description or comment history in the Search for content text field.
  • Click the Search button.

Description of form field

Search for content Searches will find issues whose summaries, descriptions or comment histories contain any of the words in the search text. It is not possible to search for words less than 3 characters long. Also commonly occurring words such as this and when are excluded from searches. These common words exist as a list maintained by the Systems Administrator.

Showing only the issues of interest

It is possible to filter the list of issues by a number of factors. This makes it easy, for example, to show only those issues that have a particular severity.

To limit the display of issues to only those of interest:
  • Choose the criteria by which you wish to filter from the Filter by drop-downs above the table.
To change the sort order of the search results:
  • Click one of the column heading links. Each time you click the same link, the order in which severity types are sorted will be reversed.

Description of table columns

Issue The id of the issue. If you have permission to view the relevant issue, the id is a link to the issue’s page.
Summary The summary of the issue, followed by square brackets containing the issue’s state, severity, type and issue topic (as a link if you have permission to view the topic).
Score The score indicates how well the search words you provided match the issue displayed. 10 points are awarded for a match in an issue summary, 5 for an issue description and 1 for an issue comment. The column also indicates by means of the characters S, D and C, if a match occurred in an issue summary, description or comment, respectively.
Selection A checkbox that, when checked, selects the issue. Selected issues are highlighted with a blue background. You can select all the issues in the current table page by clicking the checkbox in the column’s heading.

Add from advanced search

This tab lets you add issues to the milestone, by searching for issues via their summary, description and comment histories, limited to a specific topic.

The Add by issue id tab lets you add issues by their ids. The Add from search tab let you perform a topic wide search.

To search for issues to add to the milestone:
  • Enter the text that may appear in an issue’s summary, description or comment history in the Search for content text field.
  • To restrict the search, use the drop-down list boxes and Build text fields.
  • Click the Search button.
To abandon the addition of issues to the milestone:
  • Click the Reset button.

Description of form fields

Search for content Searches will find issues whose summaries, descriptions or comment histories contain any of the words in the search text. It is not possible to search for words less than 3 characters long. Also commonly occurring words such as this and when are excluded from searches. These common words exist as a list maintained by the Systems Administrator.
For topic Only issues assigned to the specified topic will be included in the search results.
Reported for Only issues with the specified Reported for field value will be included in the search results.
Build (Reported for) Only issues with the specified Build field value will be included in the search results.
Fixed in Only issues with the specified Fixed in field value will be included in the search results.
Build (Fixed in) Only issues with the specified Build field value will be included in the search results.

Showing only the issues of interest

It is possible to filter the list of issues by a number of factors. This makes it easy, for example, to show only those issues that have a particular severity.

To limit the display of issues to only those of interest:
  • Choose the criteria by which you wish to filter from the Filter by drop-downs above the table.
To change the sort order of the search results:
  • Click one of the column heading links. Each time you click the same link, the order in which severity types are sorted will be reversed.

Description of table columns

Issue The id of the issue. If you have permission to view the relevant issue, the id is a link to the issue’s page.
Summary The summary of the issue, followed by square brackets containing the issue’s state, severity, type and issue topic (as a link if you have permission to view the topic).
Score The score indicates how well the search words you provided match the issue displayed. 10 points are awarded for a match in an issue summary, 5 for an issue description and 1 for an issue comment. The column also indicates by means of the characters S, D and C, if a match occurred in an issue summary, description or comment, respectively.
Selection A checkbox that, when checked, selects the issue. Selected issues are highlighted with a blue background. You can select all the issues in the current table page by clicking the checkbox in the column’s heading.