← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: John Arbash Meinel
  • Author(s): Mark Hammond
  • Date: 2008-09-09 17:02:21 UTC
  • mto: This revision was merged to the branch mainline in revision 3697.
  • Revision ID: john@arbash-meinel.com-20080909170221-svim3jw2mrz0amp3
An updated transparent icon for bzr.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/introducing_bazaar.txt
18
18
 
19
19
This guide takes you through installing Bazaar and how to use it,
20
20
whether on your own or with a team of other people. If you're already
21
 
familiar with distributed version control and want to dive straight in,
 
21
familiar with distributed version control and want to dive straight in, 
22
22
you may wish to skim this section and jump straight to
23
23
`Learning more`_.
24
24
 
49
49
To record or *commit* these changes, the user needs access to the central
50
50
server and they need to ensure they have merged their work with the latest
51
51
version stored before trying to commit. This approach is known as the
52
 
centralized model.
 
52
centralized model. 
53
53
 
54
54
The centralized model has proven useful over time but it can have some notable
55
55
drawbacks. Firstly, a centralized VCS requires that one is able to connect
79
79
 * trunk quality and stability can be kept higher, making everyone's
80
80
   job less stressful
81
81
 
82
 
 * in open communities:
 
82
 * in open source communities:
83
83
 
84
84
   * easier for non-core developers to create and maintain changes
85
85
 
87
87
     move them into the core
88
88
 
89
89
 * in companies, easier to work with distributed and outsourced teams.
90
 
 
 
90
   
91
91
For a detailed look at the advantages of distributed VCS tools over
92
 
centralized VCS tools, see http://wiki.bazaar.canonical.com/BzrWhy.
 
92
centralized VCS tools, see http://bazaar-vcs.org/BzrWhy.
93
93
 
94
94
 
95
95
Key features of Bazaar
98
98
While Bazaar is not the only distributed VCS tool around, it does have some
99
99
notable features that make it an excellent choice for many teams and
100
100
communities. A summary of these and comparisons with other VCS tools
101
 
can be found on the Bazaar Wiki, http://wiki.bazaar.canonical.com.
 
101
can be found on the Bazaar Wiki, http://bazaar-vcs.org.
102
102
 
103
103
Of the many features, one in particular is worth highlighting:
104
104
Bazaar is completely free software written in Python. As a result,
105
105
it is easy to contribute improvements. If you wish to get involved,
106
 
please see http://wiki.bazaar.canonical.com/BzrSupport.
 
106
please see http://bazaar-vcs.org/BzrSupport.
107
107
 
108
108
 
109
109
Learning more
123
123
functionality is understood. This material can be read when required and in
124
124
any order.
125
125
 
126
 
If you are already familiar with other version control tools,
 
126
If you are already familar with other version control tools,
127
127
you may wish to get started quickly by reading the following documents:
128
128
 
129
129
 * `Bazaar in five minutes`_ - a mini-tutorial
134
134
details on the commands and options available.
135
135
 
136
136
.. _Bazaar in five minutes: ../mini-tutorial/index.html
137
 
.. _Bazaar Quick Start Card: ../quick-reference/index.html
138
 
.. _Bazaar User Reference: ../user-reference/index.html
 
137
.. _Bazaar Quick Start Card: ../quick-reference/quick-start-summary.svg
 
138
.. _Bazaar User Reference: ../user-reference/bzr_man.html
139
139
 
140
140
We hope you find this manual useful. If you have suggestions on how it
141
141
or the rest of Bazaar's documentation can be improved, please contact