~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/cycle.txt

  • Committer: Martin Pool
  • Date: 2010-01-08 00:44:26 UTC
  • mto: This revision was merged to the branch mainline in revision 4942.
  • Revision ID: mbp@sourcefrog.net-20100108004426-a0fewwjqe7a9m2bb
Review notes for stable branch

Show diffs side-by-side

added added

removed removed

Lines of Context:
385
385
Reviewing for the Stable Branch
386
386
*******************************
387
387
 
 
388
These are guidelines and can be interpreted case-by-case.
 
389
 
388
390
* All changes to the stable branch should fix a bug, even if you would not
389
391
  normally file a bug for the change.  The bug description should if at
390
392
  all possible explain how to manually verify the bug in a way that will
391
393
  fail before and pass after the change.  (These are requirements for the
392
394
  SRU process.)
393
395
 
394
 
* The change should be reasonably small and conservative.  Be extra
395
 
  careful of things that could break on other platforms or locales.
 
396
* The change should be reasonably small and conservative.  
 
397
 
 
398
* Remember that the patch will be read during the SRU
 
399
  process and so keeping the patch small is useful even beyond keeping the
 
400
  logical changes small.  Avoid doing mechanical bulk changes on the
 
401
  stable branch.
 
402
 
 
403
* Use particular care for things that may behave differently across
 
404
  platforms, encodings or locales.  It's harder to thoroughly test these
 
405
  things before a release.
 
406
 
 
407
* Generally speaking, just cleaning things up is not a sufficient reason
 
408
  to make changes to the stable branch.  It has to actually fix a bug.
 
409
 
 
410
* Changes to the stable branch should include tests as usual.  
 
411
 
 
412
* Don't change or remove existing APIs that might be used by plugins, even
 
413
  if they are underscore-prefixed.  Adding APIs that are also being added
 
414
  to the trunk branch may make sense.
 
415
 
 
416
* Keeping consistency with trunk is useful, but less important than
 
417
  keeping the stable branch stable.
396
418
 
397
419
* (more items welcome)
398
420
 
399
421
References
400
422
**********
401
423
 
402
 
#. List thread "[rfc] six-month stable release cycles", July 2009.
 
424
#. List thread "`[rfc] six-month stable release cycles`__", July 2009.
 
425
 
 
426
.. __: https://lists.ubuntu.com/archives/bazaar/2009q3/060882.html
403
427
 
404
428
..
405
429
   vim: filetype=rst textwidth=74 ai shiftwidth=4