Overview

Managing Your User Profile

Creating an Issue

Viewing an Issue

Voter and Watcher Lists

Commenting on an Issue

Exploring the Developer Issue Tracker Workspace

The Dashboard is the first page you see when you log in to the Developer Issue Tracker and has the following areas:

  • Navigation bar (at the top of the screen) — contains links to give you quick access to many of the Developer Issue Tracker's most useful functions and is the same on every page
  • Main area of the screen (below the top navigation bar) — can be customized to display different types of information, depending on your areas of interest

Learn More

Managing Your User Profile

Specify your Developer Issue Tracker settings (e.g. email address and format in which you’d like to receive email notifications) in your Developer Issue Tracker user profile. Your profile also contains links to a number of personalized reports.

To view your Developer Issue Tracker user profile:

  1. Click your user name in the top-right of the page
  2. Your user profile will be displayed

  1. From your user profile, you can:
    • Click Personal Roadmap to view your Personal Roadmap Report (i.e. work assigned to you across all projects)
    • Click Your Votes to view the list of issues for which you’ve voted
    • Click Your Watches to view the list of issues you’re watching
    • Click Change Password to change your Developer Issue Tracker password
    • Click Dashboard Config to customize your Developer Issue Tracker dashboard
    • Click Manage Filters to view and edit your issue filters
    • Click Navigator Columns to choose which fields appear in your Issue Navigator
    • Click View Preferences/Edit Preferences to view/edit the following:
      • Number of issues displayed per Issue Navigator page (the default is 50)
      • Outgoing email format (i.e. text/HTML)
      • Your preferred language
      • Email me when I make changes (i.e. whether you wish to receive email notifications about issue updates you’ve made or only about issue updates made by other people)
      • Default sharing for filters and dashboards (i.e. whether you wish your filters and dashboards to be shared with all users by default at creation. You can change the sharing for individual filters and dashboards from the default)
    • Click View Profile/Edit Profile to view/edit the following:
      • Full name (your display-name, i.e. the name by which you’re known in the Developer Issue Tracker)
      • Email (the email address to which your Developer Issue Tracker notifications will be sent)
    • Click the links under User Filters to view your:
      • Assigned issues (i.e. the list of issues assigned to you)
      • In progress issues (i.e. the list of issues assigned to you and currently have a status of In Progress)
      • Reported issues (i.e. the list of issues created by you)
    • Click the links under Assigned Open Issues per project to view the unresolved issues (if any) assigned to you for each project

Learn More

Creating an Issue

The Dashboard is the first page you see when you log in to the Developer Issue Tracker and has the following areas:

  1. Click Create New Issue at the top of the screen
  2. The Choose the project and issue type screen will be displayed. Select the relevant project and issue type, then click the Next button

  1. The Enter the details of the issue screen will be displayed. Complete any other required fields, which are italicized and highlighted by an asterisk

  1. Click the Create button at the bottom of the page. The new issue will be created and you’ll see the View Issue screen, showing the issue details you’ve provided. You may also receive an email containing details and a link to your new issue.

    To see a list of all issues you’ve created which haven’t yet been resolved, go to the Dashboard and click the My Unresolved Reported Issues link.

Learn More

Viewing an Issue

A typical issue in the Developer Issue Tracker contains the following elements:

  • Key — a unique identifier for the issue
  • Type — type of issue
  • Status — the stage the issue is currently at in its lifecycle ('workflow')
  • Priority — the importance of the issue in relation to other issues
  • Assignee — the person to whom the issue is currently assigned
  • Reporter — the person who entered the issue into the system
  • Project — the 'parent' project to which the issue belongs
  • Summary — a brief one-line summary of the issue
  • Component(s) (if applicable) — project component(s) to which this issue relates
  • Affects Version(s) (if applicable) — project version(s) for which the issue is (or was) manifesting
  • Fix Version(s) (if applicable) — project version(s) for which the issue was (or will be) fixed
  • Description — a detailed description of the issue
  • Comments — added by people working on the issue

Issue Type

The Developer Issue Tracker can be used to track the following types of issues:

  • bug icon Bug — A problem which impairs or prevents the functions of the product
  • new feature icon New Feature — A new feature of the product

Priority

An issue's priority indicates its relative importance. The default priorities are:

  • blocker priority icon Blocker — Highest priority, the issue takes precedence over all others
  • critical priority icon Critical — The issue is causing a problem and requires urgent attention
  • major priority icon Major — The issue has a significant impact
  • minor priority icon Minor — The issue has a relatively minor impact
  • trivial priority icon Trivial — Lowest priority

Status

An issue starts as being Open, then generally progresses to Resolved and then Closed; or, depending on circumstances, it may progress to other statuses.

  • open status icon Open — Issue is in the initial Open state, ready for the assignee to start work on it
  • in progress status icon In Progress — Issue is being actively worked on by the assignee
  • resolved icon Resolved — A Resolution has been identified or implemented and issue is awaiting verification by the reporter. From here, issues are either Reopened or are Closed
  • reopened icon Reopened — Issue was once Resolved or Closed, but is now being re-examined. (For example, an issue with a resolution of Cannot Reproduce is reopened when more information becomes available and the issue becomes reproducible) From here, issues are marked In Progress, Resolved or Closed
  • closed icon Closed — Issue is complete

Resolution

An issue can be resolved in many ways:

  • Fixed — A fix for this issue has been implemented
  • Won’t Fix — Issue won’t be fixed, e.g. it may no longer be relevant
  • Duplicate — Issue is a duplicate of an existing issue
  • Incomplete — There’s not enough information to work on the issue
  • Cannot Reproduce — Issue couldn’t be reproduced or not enough information was available to reproduce the issue

Learn More

Voter and Watcher Lists

The Developer Issue Tracker allows you to cast a vote for a particular issue, so you can voice your preference for that issue to be resolved or completed.

The Developer Issue Tracker also allows you to watch a particular issue and sign up to be notified of any updates relating to the issue.

You can also view the voter and watcher lists for an issue. Access the voter and watcher lists by clicking the relevant link (beside the voter/watcher total) in the issue summary when viewing an issue.

Learn More

Commenting on an Issue

Adding comments to an issue is a useful way to record additional detail about an issue and collaborate with other users.

Adding a Comment

  1. Browse to the issue you wish to comment on
  2. Click the Comment link under the Operations menu

  1. Type your comment and select which users can view this comment. Click the Add button

The Viewable By list will include all project roles to which you belong.

Hiding/showing a Comment

Hiding or showing a comment refers to whether it’s collapsed or fully visible (not to whether it’s viewable).

  1. Browse to the comment you wish to hide/show
  2. To hide a comment, click the Hide link, located on the comment
  3. To show a hidden (collapsed) comment, click the Show link, located on the comment

Editing a Comment

  1. Browse to the comment you wish to edit
  2. Click the Edit link, located on the comment
  3. Edit the comment as required
  4. Click the Save button
  5. The word Edited will be displayed to indicate the comment has been edited. You can hover your mouse over the word Edited to see who edited the comment and when