Project

General

Profile

RedmineIssues » History » Version 18

Mischa The Evil, 2010-05-09 22:55
Added right-aligned TOC

1 1 Thomas Lecavelier
h1. Issue Tracking 
2
3 18 Mischa The Evil
{{>toc}}
4
5 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.
6 1 Thomas Lecavelier
7 7 Tom Rochette
h2. Listing of the issue
8
9
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.
10
11 9 Tom Rochette
h3. Related issues
12
13
Related issues allow developers to link issues to each other in order to remove duplicates or simplify their workflow.
14
15
It is possible to link issues based on various relations. Current relations are:
16
* related to
17
* duplicates
18 11 Brice P
     If issue B is the duplicate of A
19
     - closing B will let A open
20
     - closing A will close B
21 9 Tom Rochette
* blocks
22 12 Brice P
     If issue B blocks A,
23
     A can't be closed unless B is.
24 9 Tom Rochette
* precedes
25 13 Brice P
     If B follows A, you can't give B
26
     a starting date equal or less
27
     than the ending date of A.
28 1 Thomas Lecavelier
* follows
29 12 Brice P
     If issue B follows A (ex A ends the 21/04 and B begins the 22/04)
30 11 Brice P
     and you add +2 day at the ending date of A,
31
     the starting and ending dates of B will be +2 too.
32 9 Tom Rochette
33
!redmine-related-issues.png!
34
35 10 Tom Rochette
Administrators can define the [[RedmineRoles#Permissions|permissions]] of users to add and edit such relations.
36
37 9 Tom Rochette
h3. Watchers
38
39
Display a list of all the users who are watching this issue. If the issue is updated, those users will be notified.
40
41
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.
42
43
!redmine-watchers.png!
44 10 Tom Rochette
45
Administrators can define the [[RedmineRoles#Permissions|permissions]] of users to add/delete watchers as well as to see the list of watchers.
46 9 Tom Rochette
47 7 Tom Rochette
h3. Associated revisions
48
49 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).
50 7 Tom Rochette
51
!redmine-associated-revision.png!
52
53 1 Thomas Lecavelier
h2. Adding a new issue
54
55 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]]).
56 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_.
57 1 Thomas Lecavelier
58
h2. Updating an existing issue
59
60
(TODO: describe and upload a screen-shot of update panel)
61
62 15 Tatiana Tvardovskaya
To edit the issue, Click _Update_ link (having a pen icon) at the top or the bottom of the issue page:
63
64
!RedmineEditIssue_Update_Link.png!
65
66
Depending you your role permissions (see [[RedmineRoles|roles and permissions]]), you will see a complete or a limited set of editable issue properties.
67
68 14 Tatiana Tvardovskaya
69 17 Tatiana Tvardovskaya
h2. Editing an existing issue's Subject or Description
70 1 Thomas Lecavelier
71 14 Tatiana Tvardovskaya
In order to edit an existing issue, your role has to have the [[RedmineRoles#Permissions|Issue Tracking > Edit Issues]] right in the the [[RedmineRoles|roles and permissions]] configation. 
72
This right gives you a _(More)_ link after the Change Properties section title in the "Update issue" panel.
73 1 Thomas Lecavelier
74 14 Tatiana Tvardovskaya
# Open the issue
75
# Click _Update_ link (having a pen icon) at the top or the bottom of the issue page. 
76
# See *Change properties* dialog with the _(More)_ link (see a screenshot below).
77
# Clicking on the _(More)_ link will bring-up an editable copy of the Subject and Description of the issue.
78 2 Thomas Lecavelier
79 14 Tatiana Tvardovskaya
p=. !RedmineEditIssue_More_Link_new_location.png!