RedmineIssues » History » Version 10

Tom Rochette, 2010-01-11 18:20
Added related issues and watchers permissions.

1 1 Thomas Lecavelier
h1. Issue Tracking 
2 1 Thomas Lecavelier
3 3 Mischa The Evil
Issues are the heart of the Redmine business. An issue is bound to a project, owned by a user, can be related to a version, etc.
4 1 Thomas Lecavelier
5 7 Tom Rochette
h2. Listing of the issue
6 7 Tom Rochette
7 7 Tom Rochette
From a selected issue page, you can see the work in progress that is done to fix the issue. The messages are displayed in chroonological order, starting from the oldest to the newest message. It is possible to quote others' messages as well as to edit yours.
8 7 Tom Rochette
9 9 Tom Rochette
h3. Related issues
10 9 Tom Rochette
11 9 Tom Rochette
Related issues allow developers to link issues to each other in order to remove duplicates or simplify their workflow.
12 9 Tom Rochette
13 9 Tom Rochette
It is possible to link issues based on various relations. Current relations are:
14 9 Tom Rochette
* related to
15 9 Tom Rochette
* duplicates
16 9 Tom Rochette
* blocks
17 9 Tom Rochette
* precedes
18 9 Tom Rochette
* follows
19 9 Tom Rochette
20 9 Tom Rochette
!redmine-related-issues.png!
21 9 Tom Rochette
22 10 Tom Rochette
Administrators can define the [[RedmineRoles#Permissions|permissions]] of users to add and edit such relations.
23 10 Tom Rochette
24 9 Tom Rochette
h3. Watchers
25 9 Tom Rochette
26 9 Tom Rochette
Display a list of all the users who are watching this issue. If the issue is updated, those users will be notified.
27 9 Tom Rochette
28 9 Tom Rochette
If you are logged in as a project administrator, it is possible for you to add users to the watch list on this page. By clicking on the Add link, a drop-down menu with a *Add* button appear, which allows you to select which user to add to the watch list.
29 9 Tom Rochette
30 9 Tom Rochette
!redmine-watchers.png!
31 10 Tom Rochette
32 10 Tom Rochette
Administrators can define the [[RedmineRoles#Permissions|permissions]] of users to add/delete watchers as well as to see the list of watchers.
33 9 Tom Rochette
34 7 Tom Rochette
h3. Associated revisions
35 7 Tom Rochette
36 8 Tom Rochette
If the administrator has defined [[RedmineSettings#Referencing-issues-in-commit-messages|Referencing Issues Keywords]], a developer that uses such keyword(s) will see its commit message displayed on the issue page, under the Associated revisions block (generally to the right of the first reply).
37 7 Tom Rochette
38 7 Tom Rochette
!redmine-associated-revision.png!
39 7 Tom Rochette
40 1 Thomas Lecavelier
h2. Adding a new issue
41 1 Thomas Lecavelier
42 6 Tom Rochette
People can create a new issue when they meet the [[RedmineRoles|roles and permissions]] configured by the Redmine Administrator ([[RedmineRoles#Permissions|Role: Issue Tracking > Add Issues]]).
43 4 Mischa The Evil
When creating a new issue, one of the most important items is the [[RedmineIssueTrackingSetup#Trackers|tracker field]], which defines the nature of the issue. By default, Redmine comes with three different trackers: _bug_, _feature_, and _support_.
44 1 Thomas Lecavelier
45 1 Thomas Lecavelier
h2. Updating an existing issue
46 1 Thomas Lecavelier
47 1 Thomas Lecavelier
(TODO: describe and upload a screen-shot of update panel)
48 1 Thomas Lecavelier
49 5 Anthony Cartmell
h2. Editing an existing issue's Subject or Description
50 1 Thomas Lecavelier
51 6 Tom Rochette
In order to edit an existing issue, your role has to have the [[RedmineRoles#Permissions|Issue Tracking > Edit Issues]] right. This right gives you a _(More)_ link after the Change Properties section title in the "Update issue" panel.
52 5 Anthony Cartmell
53 5 Anthony Cartmell
Clicking on the _(More)_ link will bring-up an editable copy of the Subject and Description of the issue.
54 2 Thomas Lecavelier
55 2 Thomas Lecavelier
p=. !RedmineEditIssue_More_Link.png!