/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: 2020-04-05 19:11:34 UTC
  • mto: (7490.7.16 work)
  • mto: This revision was merged to the branch mainline in revision 7501.
  • Revision ID: jelmer@jelmer.uk-20200405191134-0aebh8ikiwygxma5
Populate the .gitignore file.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/bug-handling.txt
1
1
***********************
2
 
Tracking Bugs in Bazaar
 
2
Tracking Bugs in Breezy
3
3
***********************
4
4
 
5
 
This document describes the bug-tracking processes for developing Bazaar
6
 
itself.  Bugs in Bazaar are recorded in Launchpad.
 
5
This document describes the bug-tracking processes for developing Breezy
 
6
itself.  Bugs in Breezy are recorded in Launchpad.
7
7
 
8
8
 
9
9
See also:
10
10
 
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.
 
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.
17
17
 
18
18
 
19
19
Links
20
20
*****
21
21
 
22
 
* `bzr bugs home page <https://bugs.edge.launchpad.net/bzr>`_.
23
 
 
24
 
* `Critical bugs <https://bugs.edge.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.edge.launchpad.net/bzr/+bugs>`_.
 
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>`_.
27
27
 
28
28
* `Open bugs most recently changed first
29
 
  <https://bugs.edge.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=>`_.
 
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=>`_.
30
30
 
31
 
* `Most commonly duplicated bugs <http://tinyurl.com/bzr-bugs-by-dupes>`_.
 
31
* `Most commonly duplicated bugs <http://tinyurl.com/brz-bugs-by-dupes>`_.
32
32
 
33
33
 
34
34
Generalities
35
35
************
36
36
 
37
 
Anyone involved with Bazaar is welcome to contribute to managing our bug
 
37
Anyone involved with Breezy 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 Bazaar developer or active user, if you feel
 
43
When you file a bug as a Breezy 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
 
efficient to change the importance if someone else feel's it's higher or
 
46
efficient to change the importance if someone else feels it's higher or
47
47
lower, than to have someone else edit all bugs.
48
48
 
49
49
It's more useful to actually ship bug fixes than to garden the bug
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
146
148
    The bug report has been seen by a developer and we agree it's a bug.
147
 
    You don't have to reproduce the bug to mark it Confirmed.  (Generally
 
149
    You don't have to reproduce the bug to mark it Triaged.  (Generally
148
150
    it's not a good idea for a developer to spend time reproducing the bug
149
151
    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.
153
152
In Progress
154
153
    Someone has started working on this.  We can deliver the value of the
155
 
    work already done by finishing and shipping the fix.  
156
 
    
 
154
    work already done by finishing and shipping the fix.
 
155
 
157
156
    The bug keeps this state from the time someone does non-trivial
158
157
    analysis, until the fix is merged to a release or trunk branch (when
159
158
    it is Fix Released), or until they give up on it (back to New or
169
168
    Don't use this.  If set on old bug, it probably means In Progress,
170
169
    with the fix waiting for review.  See Launchpad `bug 163694`_.
171
170
Fix Released
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
 
    
 
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
 
175
174
    We use this value even though the fix may not have been been included
176
175
    in a release yet because all the developer activity around it is
177
176
    complete and we want to both avoid bug spam when releases happen, and
178
177
    keep the list of bugs that developers see when they look at the bug
179
 
    tracker trimmed to those that require action. 
180
 
    
 
178
    tracker trimmed to those that require action.
 
179
 
181
180
    When setting a bug task to fix released, the bug target milestone
182
181
    should be set to the release the fix will be included in (or was
183
182
    included in, if you are updating an old bug). Don't spend too much
184
183
    time updating this if you don't immediately know: its not critical
185
184
    that it be set.
186
185
 
187
 
.. _`bug 163694`: https://bugs.launchpad.net/malone/+bug/163694
 
186
.. _`bug 163694`: https://bugs.launchpad.net/launchpad/+bug/163694
188
187
 
189
188
 
190
189
Bug Importance
191
190
**************
192
191
 
193
192
Critical
194
 
    This is a serious bug that could cause data loss, stop bzr being
 
193
    This is a serious bug that could cause data loss, stop Breezy being
195
194
    usable in an important case, or represents a regression in something
196
195
    previously working.  We should fix critical bugs before doing other
197
196
    work, or seriously consider whether the bug is really critical
198
197
    or whether the other change is more urgent.
199
198
High
200
199
    This is a bug that can seriously interfere with people's use of
201
 
    Bazaar.  We should seriously consider fixing these bugs before
 
200
    Breezy.  We should seriously consider fixing these bugs before
202
201
    working on new features.
203
202
Medium
204
203
    A regular bug.  We'd like to fix them, but there may be a long delay.
228
227
***************
229
228
 
230
229
It's possible to target a bug to a milestone, eg
231
 
<https://bugs.edge.launchpad.net/bzr/+milestone/1.16>.  We use this to help the
 
230
<https://bugs.launchpad.net/brz/+milestone/1.16>.  We use this to help the
232
231
release manager know what **must** be merged to make the release.
233
232
 
234
233
Therefore, we don't target bugs that we'd like to have fixed or that could
255
254
separate work to get it into that release.
256
255
 
257
256
 
258
 
The News File
 
257
Release Notes
259
258
*************
260
259
 
261
 
Most bugs that are fixed should be mentioned in a `NEWS
262
 
<../en/release-notes/NEWS.html>`_ file entry,
 
260
Most bugs that are fixed should be mentioned in the `Release Notes
 
261
<../en/release-notes/>`_ for the forthcoming version,
263
262
including the bug number.
264
263
(Exceptions might be bugs that are not at all user visible.)
265
264
 
267
266
Tags
268
267
****
269
268
 
270
 
Here are some bug tags we use.  In Malone tags are currently of limited use, so don't feel obliged to tag bugs unless you're finding it useful.
 
269
Here are some bug tags we use.  In Launchpad Bugs tags are currently of limited use, so don't feel obliged to tag bugs unless you're finding it useful.
271
270
 
272
271
 
273
272
authentication
289
288
    bugs for causes of VFS methods of the smart server
290
289
 
291
290
launchpad
292
 
    bugs about interactions with launchpad (typically this means bzrlib.plugins.launchpad).
 
291
    bugs about interactions with launchpad (typically this means breezy.plugins.launchpad).
293
292
 
294
293
locale
295
294
    problems using locales other than English
303
302
performance
304
303
    bugs about performance problems.
305
304
 
 
305
regression
 
306
    bugs which represent an aspect of Breezy becoming accidentally less good than it was.
 
307
 
306
308
test
307
309
    needs changes to the test framework
308
310
 
309
311
transport
310
 
    virtual filesystem for http, sftp, etc
 
312
    virtual filesystem for HTTP, SFTP, etc.
311
313
 
312
314
trivial
313
 
    should be very easy to fix (10-20 minutes) and easily landed: typically just spelling errors and the like
 
315
    should be very easy to fix (10-20 minutes) and easily landed: typically
 
316
    just spelling errors and the like
314
317
 
315
318
ui
316
 
    bugs relating to the bzr user interface, e.g. confusing error messages.
 
319
    bugs relating to the Breezy user interface, e.g. confusing error messages.
317
320
 
318
321
win32
319
 
    bugs that mainly affects Windows. Also there is cygwin and win98 tags for marking specific bugs.
 
322
    bugs that mainly affects Windows. Also there is cygwin and win98 tags for
 
323
    marking specific bugs.
320
324
 
321
325
You can see the full list of tags in use at
322
 
<https://bugs.edge.launchpad.net/bzr/+bugs>.  As of September 2008 the
 
326
<https://bugs.launchpad.net/brz/+bugs>.  As of September 2008 the
323
327
list is on the right.
324
328
 
325
329
.. vim: ft=rst