Printable Documentation

Ian Clatworthy ian.clatworthy at internode.on.net
Sun Jan 11 23:07:26 GMT 2009


David Muir wrote:
> 
> I find it really frustrating having to constantly flip between
> the user reference and the user guide. Especially when the guide has
> info about commands that is missing in the reference... But that's a
> gripe for another day...

David,

Thanks for the feedback.

FWIW, the Guide is meant as an introduction to the most commonly used
stuff, explaining HOW to use the product and WHY it's designed
the way it is. OTOH, the Reference ought to comprehensively cover
exactly WHAT the product does.

I'll *gladly* accept improvements to the Reference doc to fix the
problem you're highlighting. In terms of core product information,
the Reference ought to be a superset of the Guide. For example,
I'd like to see many more examples added to the Reference doc so
that those in the User Guide were a subset.

Ian C.



More information about the bazaar mailing list