/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: Jelmer Vernooij
  • Date: 2017-07-23 22:06:41 UTC
  • mfrom: (6738 trunk)
  • mto: This revision was merged to the branch mainline in revision 6739.
  • Revision ID: jelmer@jelmer.uk-20170723220641-69eczax9bmv8d6kk
Merge trunk, address review comments.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/bug-handling.txt
1
1
***********************
2
 
Tracking Bugs in Breezy
 
2
Tracking Bugs in Bazaar
3
3
***********************
4
4
 
5
 
This document describes the bug-tracking processes for developing Breezy
6
 
itself.  Bugs in Breezy are recorded in Launchpad.
 
5
This document describes the bug-tracking processes for developing Bazaar
 
6
itself.  Bugs in Bazaar are recorded in Launchpad.
7
7
 
8
8
 
9
9
See also:
10
10
 
11
 
* `Breezy Developer Documents <index.html>`_.
12
 
 
13
 
* `The Breezy Development Cycle <cycle.html>`_.
14
 
 
15
 
* `The Breezy User Guide <../en/user-guide/index.html>`_ -- for
16
 
  information on integrating Breezy with other bug trackers.
 
11
* `Bazaar Developer Documents <index.html>`_.
 
12
 
 
13
* `The Bazaar Development Cycle <cycle.html>`_.
 
14
 
 
15
* `The Bazaar User Guide <../en/user-guide/index.html>`_ -- for
 
16
  information on integrating Bazaar with other bug trackers.
17
17
 
18
18
 
19
19
Links
20
20
*****
21
21
 
22
 
* `Breezy bugs home page <https://bugs.launchpad.net/brz>`_.
23
 
 
24
 
* `Critical bugs <https://bugs.launchpad.net/brz/+bugs?search=Search&field.importance=Critical&field.status=New&field.status=Incomplete&field.status=Confirmed&field.status=Triaged&field.status=In+Progress&field.status=Fix+Committed>`_.
25
 
 
26
 
* `Open bugs by importance <https://bugs.launchpad.net/brz/+bugs>`_.
 
22
* `bzr bugs home page <https://bugs.launchpad.net/bzr>`_.
 
23
 
 
24
* `Critical bugs <https://bugs.launchpad.net/bzr/+bugs?search=Search&field.importance=Critical&field.status=New&field.status=Incomplete&field.status=Confirmed&field.status=Triaged&field.status=In+Progress&field.status=Fix+Committed>`_.
 
25
 
 
26
* `Open bugs by importance <https://bugs.launchpad.net/bzr/+bugs>`_.
27
27
 
28
28
* `Open bugs most recently changed first
29
 
  <https://bugs.launchpad.net/brz/+bugs?field.searchtext=&orderby=-date_last_updated&search=Search&field.status%3Alist=NEW&field.status%3Alist=INCOMPLETE_WITH_RESPONSE&field.status%3Alist=INCOMPLETE_WITHOUT_RESPONSE&field.status%3Alist=CONFIRMED&field.status%3Alist=TRIAGED&field.status%3Alist=INPROGRESS&field.status%3Alist=FIXCOMMITTED&field.assignee=&field.bug_reporter=&field.omit_dupes=on&field.has_patch=&field.has_no_package=>`_.
 
29
  <https://bugs.launchpad.net/bzr/+bugs?field.searchtext=&orderby=-date_last_updated&search=Search&field.status%3Alist=NEW&field.status%3Alist=INCOMPLETE_WITH_RESPONSE&field.status%3Alist=INCOMPLETE_WITHOUT_RESPONSE&field.status%3Alist=CONFIRMED&field.status%3Alist=TRIAGED&field.status%3Alist=INPROGRESS&field.status%3Alist=FIXCOMMITTED&field.assignee=&field.bug_reporter=&field.omit_dupes=on&field.has_patch=&field.has_no_package=>`_.
30
30
 
31
 
* `Most commonly duplicated bugs <http://tinyurl.com/brz-bugs-by-dupes>`_.
 
31
* `Most commonly duplicated bugs <http://tinyurl.com/bzr-bugs-by-dupes>`_.
32
32
 
33
33
 
34
34
Generalities
35
35
************
36
36
 
37
 
Anyone involved with Breezy is welcome to contribute to managing our bug
 
37
Anyone involved with Bazaar is welcome to contribute to managing our bug
38
38
reports.  **Edit boldly**: try to help users out, assess importance or improve
39
39
the bug description or status.  Other people will see the bugs: it's
40
40
better to have 20 of them processed and later change the status of a
41
41
couple than to leave them lie.
42
42
 
43
 
When you file a bug as a Breezy developer or active user, if you feel
 
43
When you file a bug as a Bazaar developer or active user, if you feel
44
44
confident in doing so, make an assessment of status and importance at the
45
45
time you file it, rather than leaving it for someone else.  It's more
46
46
efficient to change the importance if someone else feels it's higher or
143
143
    progress on the bug without that information.  The bug will expire if
144
144
    it remains in this state for two months.
145
145
Confirmed
146
 
    This bug has been confirmed by at least one other person (developer or otherwise).
147
 
Triaged
148
146
    The bug report has been seen by a developer and we agree it's a bug.
149
 
    You don't have to reproduce the bug to mark it Triaged.  (Generally
 
147
    You don't have to reproduce the bug to mark it Confirmed.  (Generally
150
148
    it's not a good idea for a developer to spend time reproducing the bug
151
149
    until they're going to work on it.)
 
150
Triaged
 
151
    We don't use this status.  If it is set, it means the same as
 
152
    Confirmed.
152
153
In Progress
153
154
    Someone has started working on this.  We can deliver the value of the
154
 
    work already done by finishing and shipping the fix.
155
 
 
 
155
    work already done by finishing and shipping the fix.  
 
156
    
156
157
    The bug keeps this state from the time someone does non-trivial
157
158
    analysis, until the fix is merged to a release or trunk branch (when
158
159
    it is Fix Released), or until they give up on it (back to New or
168
169
    Don't use this.  If set on old bug, it probably means In Progress,
169
170
    with the fix waiting for review.  See Launchpad `bug 163694`_.
170
171
Fix Released
171
 
    The fix for this bug is now in the Breezy branch that this task is for.
172
 
    The branch for the default task on a bug is trunk.
173
 
 
 
172
    The fix for this bug is now in the bzr branch that this task is for.
 
173
    The branch for the default task on a bug is bzr.dev.  
 
174
    
174
175
    We use this value even though the fix may not have been been included
175
176
    in a release yet because all the developer activity around it is
176
177
    complete and we want to both avoid bug spam when releases happen, and
177
178
    keep the list of bugs that developers see when they look at the bug
178
 
    tracker trimmed to those that require action.
179
 
 
 
179
    tracker trimmed to those that require action. 
 
180
    
180
181
    When setting a bug task to fix released, the bug target milestone
181
182
    should be set to the release the fix will be included in (or was
182
183
    included in, if you are updating an old bug). Don't spend too much
190
191
**************
191
192
 
192
193
Critical
193
 
    This is a serious bug that could cause data loss, stop Breezy being
 
194
    This is a serious bug that could cause data loss, stop bzr being
194
195
    usable in an important case, or represents a regression in something
195
196
    previously working.  We should fix critical bugs before doing other
196
197
    work, or seriously consider whether the bug is really critical
197
198
    or whether the other change is more urgent.
198
199
High
199
200
    This is a bug that can seriously interfere with people's use of
200
 
    Breezy.  We should seriously consider fixing these bugs before
 
201
    Bazaar.  We should seriously consider fixing these bugs before
201
202
    working on new features.
202
203
Medium
203
204
    A regular bug.  We'd like to fix them, but there may be a long delay.
227
228
***************
228
229
 
229
230
It's possible to target a bug to a milestone, eg
230
 
<https://bugs.launchpad.net/brz/+milestone/1.16>.  We use this to help the
 
231
<https://bugs.launchpad.net/bzr/+milestone/1.16>.  We use this to help the
231
232
release manager know what **must** be merged to make the release.
232
233
 
233
234
Therefore, we don't target bugs that we'd like to have fixed or that could
288
289
    bugs for causes of VFS methods of the smart server
289
290
 
290
291
launchpad
291
 
    bugs about interactions with launchpad (typically this means breezy.plugins.launchpad).
 
292
    bugs about interactions with launchpad (typically this means bzrlib.plugins.launchpad).
292
293
 
293
294
locale
294
295
    problems using locales other than English
303
304
    bugs about performance problems.
304
305
 
305
306
regression
306
 
    bugs which represent an aspect of Breezy becoming accidentally less good than it was.
 
307
    bugs which represent an aspect of bzr becoming accidentally less good than it was.
307
308
 
308
309
test
309
310
    needs changes to the test framework
312
313
    virtual filesystem for HTTP, SFTP, etc.
313
314
 
314
315
trivial
315
 
    should be very easy to fix (10-20 minutes) and easily landed: typically
 
316
    should be very easy to fix (10-20 minutes) and easily landed: typically 
316
317
    just spelling errors and the like
317
318
 
318
319
ui
319
 
    bugs relating to the Breezy user interface, e.g. confusing error messages.
 
320
    bugs relating to the bzr user interface, e.g. confusing error messages.
320
321
 
321
322
win32
322
 
    bugs that mainly affects Windows. Also there is cygwin and win98 tags for
 
323
    bugs that mainly affects Windows. Also there is cygwin and win98 tags for 
323
324
    marking specific bugs.
324
325
 
325
326
You can see the full list of tags in use at
326
 
<https://bugs.launchpad.net/brz/+bugs>.  As of September 2008 the
327
 
list is on the right.
 
327
<https://bugs.launchpad.net/bzr/+bugs>.  As of September 2008 the
 
328
list is on the right. 
328
329
 
329
330
.. vim: ft=rst