/breezy/unstable

To get this branch, use:
bzr branch https://code.breezy-vcs.org/breezy/unstable

« back to all changes in this revision

Viewing changes to doc/en/user-guide/bazaar_workflows.txt

  • Committer: Jelmer Vernooij
  • Date: 2017-05-24 01:39:33 UTC
  • mfrom: (3815.3776.6)
  • Revision ID: jelmer@jelmer.uk-20170524013933-ir4y4tqtrsiz2ka2
New upstream snapshot.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
Workflows
2
2
=========
3
3
 
4
 
Bazaar is just a tool
 
4
Breezy is just a tool
5
5
---------------------
6
6
 
7
 
Bazaar supports many different ways of working together.
 
7
Breezy supports many different ways of working together.
8
8
This means that you can
9
9
start with one workflow and adapt it over time as circumstances
10
10
change. There is no "one true way" that always makes sense and
11
11
there never will be. This section provides a brief overview of
12
 
some popular workflows supported by Bazaar.
 
12
some popular workflows supported by Breezy.
13
13
 
14
14
Keep in mind that these workflow are just *some* examples of how
15
 
Bazaar can be used. You may want to use a workflow not listed here,
 
15
Breezy can be used. You may want to use a workflow not listed here,
16
16
perhaps building on the ideas below.
17
17
 
18
18
Solo
30
30
 * rollback to an earlier state
31
31
 * tracking of history.
32
32
 
33
 
The key features of Bazaar appropriate for this workflow are low administration
 
33
The key features of Breezy appropriate for this workflow are low administration
34
34
(no server setup) and ease of use.
35
35
 
36
36
 
51
51
 * each line of each text file can be attributed to a particular change
52
52
   including who changed it, when and why.
53
53
 
54
 
When implementing this workflow, Bazaar's advantages over CVS and Subversion include:
 
54
When implementing this workflow, Breezy's advantages over CVS and Subversion include:
55
55
 
56
56
 * no server to setup
57
57
 * intelligent merging means merging multiple times isn't painful.
62
62
 
63
63
Also known as *lock-step*, this is essentially the same as the workflow
64
64
encouraged/enforced by CVS and Subversion. All developers work on the same
65
 
branch (or branches). They run ``bzr update`` to get their checkout up-to-date,
66
 
then ``bzr commit`` to publish their changes to the central location.
 
65
branch (or branches). They run ``brz update`` to get their checkout up-to-date,
 
66
then ``brz commit`` to publish their changes to the central location.
67
67
 
68
68
.. image:: images/workflows_centralized.png
69
69
 
70
70
Subversion and CVS are good choices for implementing this workflow because they
71
 
make it easy. Bazaar directly supports it as well while providing some
 
71
make it easy. Breezy directly supports it as well while providing some
72
72
important advantages over CVS and Subversion:
73
73
 
74
74
 * better branching and merging
91
91
 * Less chance for a bad commit to interfere with everyone else's work
92
92
 
93
93
Subversion and CVS do not support this model. Other distributed VCS tools can
94
 
support it but do so less directly than Bazaar does.
 
94
support it but do so less directly than Breezy does.
95
95
 
96
96
 
97
97
Decentralized with shared mainline
109
109
 * Developers can merge one another's personal branches when working on something together.
110
110
 
111
111
Subversion and CVS do not support this model. Other distributed VCS
112
 
tools support it. Many features of Bazaar are good for this workflow
 
112
tools support it. Many features of Breezy are good for this workflow
113
113
including ease of use, shared repositories, integrated merging and
114
114
rich metadata (including directory rename tracking).
115
115
 
130
130
 * Code is always reviewed before it enters the mainline
131
131
 * Tighter control over when changes get incorporated into the mainline.
132
132
 
133
 
A companion tool of Bazaar's called Bundle Buggy can be very useful for
 
133
A companion tool of Breezy's called Bundle Buggy can be very useful for
134
134
tracking what changes are up for review, their status and reviewer comments.
135
135
 
136
136
 
158
158
   mainline is higher)
159
159
 * Scales better as teams grow.
160
160
 
161
 
A companion tool of Bazaar's called Patch Queue Manager (PQM) can provide the
 
161
A companion tool of Breezy's called Patch Queue Manager (PQM) can provide the
162
162
automated gatekeeper capability.
163
163
 
164
164