[MERGE] Reduce evangelism in the User Guide
Martin Pool
mbp at canonical.com
Fri Mar 28 00:51:02 GMT 2008
Definitely a nice improvement.
> FWIW, I continue to think that manuals without editorial comment now and then can become very dull. A balance is required.
I agree having an authorial voice and a bit of opinion in the manual
makes it both interesting and authentic; I'd see this more as more
accurately expressing how we feel rather than editing it out.
+The online help and `Bazaar User Reference`_ provide all the gory details
+on the commands and options available.
Is "gory details" is an Australianism? At any rate it may confuse
some readers. I'd just put "more details".
--
Martin <http://launchpad.net/~mbp/>
More information about the bazaar
mailing list