← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/bug-handling.txt

  • Committer: Martin Pool
  • Date: 2010-01-12 02:00:23 UTC
  • mto: This revision was merged to the branch mainline in revision 4949.
  • Revision ID: mbp@sourcefrog.net-20100112020023-ib3ii1wcpvljmprk
Update bug handling doc to deprecate fixcommitted and to explain other states better

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/bug-handling.txt
136
136
    yet.
137
137
Incomplete
138
138
    The bug requires more information from the reporter to make progress.
 
139
 
 
140
    Only set this state if it's impossible or uneconomical to make
 
141
    progress on the bug without that information.  The bug will expire if
 
142
    it remains in this state for two months.
139
143
Confirmed
140
144
    The bug report has been seen by a developer and we agree it's a bug.
141
 
    You don't have to reproduce the bug to mark it confirmed.  (Generally
 
145
    You don't have to reproduce the bug to mark it Confirmed.  (Generally
142
146
    it's not a good idea for a developer to spend time reproducing the bug
143
147
    until they're going to work on it.)
144
148
Triaged
145
149
    We don't use this status.  If it is set, it means the same as
146
150
    Confirmed.
147
151
In Progress
148
 
    Someone has started working on this.
 
152
    Someone has started working on this.  We can deliver the value of the
 
153
    work already done by finishing and shipping the fix.  
 
154
    
 
155
    The bug keeps this state from the time someone does non-trivial
 
156
    analysis, until the fix is merged to a release or trunk branch (when
 
157
    it is Fix Released), or until they give up on it (back to New or
 
158
    Confirmed) or decide it is Invalid or Incomplete.
149
159
Won't Fix
150
160
    The behaviour complained about is intentional and we won't fix it.
151
161
    Needless to say, be thoughtful before using this status, and consider if
154
164
    The reporter was confused, and this is not actually a bug.
155
165
    Again, be sensitive in explaining this to the user.
156
166
Fix Committed
157
 
    A fix for this bug exists in a branch somewhere.  Ideally the bug will
158
 
    be linked to the branch.
 
167
    Don't use this.  If set on old bug, it probably means In Progress,
 
168
    with the fix waiting for review.  See Launchpad `bug 163694`_.
159
169
Fix Released
160
170
    The fix for this bug is now in the bzr branch that this task is for.
161
 
    The branch for the default task on a bug is bzr.dev.  We use this value
162
 
    even though the fix may not have been been included in a release yet
163
 
    because all the developer activity around it is complete and we want to
164
 
    both avoid bug spam when releases happen, and keep the list of bugs that
165
 
    developers see when they look at the bug tracker trimmed to those that
166
 
    require action. When setting a bug task to fix released, the bug target
167
 
    milestone should be set to the release the fix will be included in (or
168
 
    was included in, if you are updating an old bug). Don't spend too much time
169
 
    updating this if you don't immediately know: its not critical that it be
170
 
    set.
 
171
    The branch for the default task on a bug is bzr.dev.  
 
172
    
 
173
    We use this value even though the fix may not have been been included
 
174
    in a release yet because all the developer activity around it is
 
175
    complete and we want to both avoid bug spam when releases happen, and
 
176
    keep the list of bugs that developers see when they look at the bug
 
177
    tracker trimmed to those that require action. 
 
178
    
 
179
    When setting a bug task to fix released, the bug target milestone
 
180
    should be set to the release the fix will be included in (or was
 
181
    included in, if you are updating an old bug). Don't spend too much
 
182
    time updating this if you don't immediately know: its not critical
 
183
    that it be set.
 
184
 
 
185
.. _`bug 163694`: https://bugs.launchpad.net/malone/+bug/163694
171
186
 
172
187
 
173
188
Bug Importance