← 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: Canonical.com Patch Queue Manager
  • Date: 2008-03-28 03:28:01 UTC
  • mfrom: (3311.1.1 ianc-integration)
  • Revision ID: pqm@pqm.ubuntu.com-20080328032801-o2sda79zu2g6ckxg
Reduced the evangelism in the User Guide (Ian Clatworthy)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/introducing_bazaar.txt
26
26
------------------------------------------
27
27
 
28
28
Version control tools have been evolving for several decades now. In
29
 
simple terms, there have been 5 generations of tools:
 
29
simple terms, there have been 4 generations of tools:
30
30
 
31
31
 1. file versioning tools, e.g. SCCS, RCS
32
32
 2. tree versioning tools - central style, e.g. CVS
33
 
 3. tree versioning tools - central style, done right, e.g. Subversion
34
 
 4. tree versioning tools - distributed style, e.g. Arch
35
 
 5. tree versioning tools - distributed style, done right, e.g. Bazaar.
 
33
 3. tree versioning tools - central style, take two, e.g. Subversion
 
34
 4. tree versioning tools - distributed style, e.g. Bazaar.
36
35
 
37
36
The design and implementation of Bazaar builds on the lessons learned
38
37
from all the previous generations of tools. In particular, Bazaar
98
97
 
99
98
While Bazaar is not the only distributed VCS tool around, it does have some
100
99
notable features that make it an excellent choice for many teams and
101
 
communities. These include:
102
 
 
103
 
 * it **Just Works** - a high focus on usability and performance
104
 
 * **adaptive** - cleanly supports many different ways of working together
105
 
 * **rich metadata** that tracks merge history across distributed locations,
106
 
   understands directories as first-class objects and correctly tracks
107
 
   renames of both files and directories
108
 
 * **integrated merging** that uses this metadata intelligently to
109
 
   ensure that merging is safe without being painful, letting you
110
 
   collaborate without fear
111
 
 * **truly portable** across many operating systems including Windows
112
 
 * **safe with your data** - integrity is checked using cryptographic
113
 
   techniques and all changes can be digitally signed if required
114
 
 * **low administration**, e.g. access to FTP or SFTP is enough to
115
 
   share with others - no special server required
116
 
 * **efficiently stores data** across branches in a flexible and safe way
117
 
 * an **open architecture and API** that makes it easy to integrate
118
 
   with other tools
119
 
 * a **large number of plugins** including bzr-svn and GUI front-ends
120
 
 * **excellent integration** with a range of companion tools and services
121
 
   including PQM, Bundle Buggy and Launchpad
122
 
 * **completely open source**
123
 
 * **commercial training and support** available from Canonical,
124
 
   the company that sponsors Ubuntu.
125
 
 
126
 
While all of these are important, perhaps the greatest asset Bazaar has is
127
 
an active and growing open source community behind it. Bazaar is completely
128
 
free software written in Python so it is easy to contribute improvements.
129
 
Our collective goal is to build and support a distributed VCS tool that
130
 
developers love to use, a tool that helps them get their job done without
131
 
getting in their way. If you wish to get involved, please see
132
 
http://bazaar-vcs.org/BzrSupport.
 
100
communities. A summary of these and comparisons with other VCS tools
 
101
can be found on the Bazaar Wiki, http://bazaar-vcs.org.
 
102
 
 
103
Of the many features, one in particular is worth highlighting:
 
104
Bazaar is completely free software written in Python. As a result,
 
105
it is easy to contribute improvements. If you wish to get involved,
 
106
please see http://bazaar-vcs.org/BzrSupport.
133
107
 
134
108
 
135
109
Learning more
155
129
 
156
130
 * `Bazaar Quick Start Card`_ - a one page summary of commonly used commands.
157
131
 
158
 
The online help and `Bazaar User Reference`_ are also particularly useful as
159
 
they provide all the gory details on the commands and options available.
 
132
In addition, the online help and `Bazaar User Reference`_ provide all the
 
133
details on the commands and options available.
160
134
 
161
135
.. _Bazaar in five minutes: ../mini-tutorial/index.html
162
136
.. _Bazaar Quick Start Card: ../quick-reference/quick-start-summary.svg