112
|
1 @node States
|
|
2 @section States of Problem Reports
|
|
3
|
|
4 @cindex life-cycle of a Problem Report
|
|
5 @cindex states of Problem Reports
|
|
6 @cindex Problem Report states
|
|
7 @cindex automatic notification
|
|
8
|
|
9 Each PR goes through a defined series of states between origination and
|
|
10 closure. The originator of a PR receives notification automatically of
|
|
11 any state changes.
|
|
12
|
|
13 @table @dfn
|
|
14 @cindex @emph{open} state
|
|
15 @cindex initial state (@dfn{open})
|
|
16 @cindex state---@dfn{open}
|
|
17 @item open
|
|
18 The initial state of a Problem Report. This means the PR has been filed
|
|
19 and the responsible person(s) notified.
|
|
20
|
|
21 @cindex @emph{analyzed} state
|
|
22 @cindex state---@dfn{analyzed}
|
|
23 @item analyzed
|
|
24 The responsible person has analyzed the problem. The analysis should
|
|
25 contain a preliminary evaluation of the problem and an estimate of the
|
|
26 amount of time and resources necessary to solve the problem. It should
|
|
27 also suggest possible workarounds.
|
|
28
|
|
29 @cindex @emph{feedback} state
|
|
30 @cindex state---@dfn{feedback}
|
|
31 @item feedback
|
|
32 The problem has been solved, and the originator has been given a patch
|
|
33 or other fix. The PR remains in this state until the originator
|
|
34 acknowledges that the solution works.
|
|
35
|
|
36 @cindex @emph{closed} state
|
|
37 @cindex state---@dfn{closed}
|
|
38 @cindex final state (@dfn{closed})
|
|
39 @item closed
|
|
40 A Problem Report is closed (``the bug stops here'') only when any
|
|
41 changes have been integrated, documented, and tested, and the submitter
|
|
42 has confirmed the solution.
|
|
43
|
|
44 @cindex @emph{suspended} state
|
|
45 @cindex state---@dfn{suspended}
|
|
46 @item suspended
|
|
47 Work on the problem has been postponed. This happens if a timely
|
|
48 solution is not possible or is not cost-effective at the present time.
|
|
49 The PR continues to exist, though a solution is not being actively
|
|
50 sought. If the problem cannot be solved at all, it should be closed
|
|
51 rather than suspended.
|
|
52 @end table
|
|
53
|