[MERGE] Reduce evangelism in the User Guide

Aaron Bentley aaron at aaronbentley.com
Thu Mar 27 16:49:11 GMT 2008


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Ian Clatworthy wrote:
> A number of users including Paul Moore and Stephen Turnbull have
> indicated that they find the tone of the User Guide grating at times.
> This patch removes some of the over-enthusiastic text phrases and
> section from the opening chapters. This certainly improves the
> signal-to-noise ratio and hopefully makes the manual more acceptable to
> more people.

The workflows document was originally an evangelism document.  It shows
how Bazaar can adapt to a myriad of different workflows, and highights
how that makes Bazaar better than its competitors.  Some of its
competitors can't even conceive of the level of support we bring,
causing the arguments we see on the BazaarVsHg page.

It's not meant to be a guide to implementing those workflows-- it just
doesn't have the level of detail required.  Such detail would have
bogged down its evangelism.

So I'm starting to question whether it even belongs in the user guide.

Aaron
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFH69AH0F+nu1YWqI0RAjqDAJ44u1plV84OOZoMK52jU138RZowTACeN/4G
A06t71N3cH0Zb81CMqZYI6Q=
=kTeW
-----END PGP SIGNATURE-----



More information about the bazaar mailing list