← Back to branch summary

~launchpad-pqm/launchpad/devel

« back to all changes in this revision

Viewing changes to lib/lp/bugs/doc/bug-nomination.txt

  • Committer: Launchpad Patch Queue Manager
  • Date: 2011-12-26 06:01:53 UTC
  • mfrom: (14575.2.4 megalint-9)
  • Revision ID: launchpad@pqm.canonical.com-20111226060153-1rfmi1yn90lu4fuf
[r=jtv][no-qa] Lint.

Show diffs side-by-side

added added

removed removed

Lines of Context:
lib/lp/bugs/doc/bug-nomination.txt
1
 
= Bug Nomination =
 
1
Bug Nomination
 
2
==============
2
3
 
3
4
A bug supervisor can nominate a bug to be fixed in a specific
4
5
distribution or product series. Nominations are created by
152
153
    [u'Ubuntu Grumpy', u'Ubuntu Hoary']
153
154
 
154
155
 
155
 
== Nomination Status ==
 
156
Nomination Status
 
157
-----------------
156
158
 
157
159
A nomination is created with an initial status of "Nominated".
158
160
Internally this state is called PROPOSED, but in the UI we display it
214
216
    >>> login("no-priv@canonical.com")
215
217
 
216
218
 
217
 
== Approving a nomination ==
 
219
Approving a nomination
 
220
----------------------
218
221
 
219
222
When a nomination is approved, the appropriate bugtask(s) are created on
220
223
the target of the nomination and the status is set to APPROVED.
347
350
    >>> ubuntu_warty.driver = None
348
351
 
349
352
 
350
 
== Declining a nomination ==
 
353
Declining a nomination
 
354
----------------------
351
355
 
352
356
Declining a nomination simply sets its status to DECLINED. No tasks are
353
357
created.
396
400
    None
397
401
 
398
402
 
399
 
== Automatic targeting of new source packages ==
 
403
Automatic targeting of new source packages
 
404
------------------------------------------
400
405
 
401
406
If a another distribution task is added, and nomination for that
402
407
distribution's series already exists, the nominations will be valid
436
441
    ...
437
442
 
438
443
 
439
 
== Changing the Source Package of a Targeted Bugtask ==
 
444
Changing the Source Package of a Targeted Bugtask
 
445
-------------------------------------------------
440
446
 
441
447
The nomination model requires that a generic distribution task exists
442
448
for each distroseries task. This causes some problem when renaming the
505
511
    thunderbird (Ubuntu)
506
512
 
507
513
 
508
 
== Bug Nomination Set ==
 
514
Bug Nomination Set
 
515
------------------
509
516
 
510
517
IBugNominationSet is used to fetch bug nominations by ID. This is useful
511
518
mainly in traversal code.
523
530
    NotFoundError: ...
524
531
 
525
532
 
526
 
== Error Handling ==
 
533
Error Handling
 
534
--------------
527
535
 
528
536
Trying to nominate a bug for a series for which it's already nominated
529
537
or targeted raises a NominationError.