Pushing after merge considered harmful

[Eli Zaretskii]

> Date: Wed, 27 Jan 2010 09:43:10 +1000
> From: Ian Clatworthy <ian.clatworthy at canonical.com>
> CC: Eli Zaretskii <eliz at gnu.org>, bialix at ukr.net, 
>  bazaar at lists.canonical.com
> 
> Matthew D. Fuller wrote:
> 
> > But the only way to
> > really ride Roman across that divide is to have two sets of
> > documentation, a "soft" set for the masses, and a "hard" set for the
> > cranky brainiacs.
> 
> I think we can cover our various audiences by having just the one set of
> documentation with layers within it:
> 
> 1. The User Guide - process centric and aimed at anyone wanting VC
> 2. The User Reference - all the nuts & bolts in detail.

It could be a starting point, although I'd not deny any user the
ability to read the reference.

> Perhaps Matthew's wiki pages and/or Alexander's articles can be turned
> into concept topics and included there?

Definitely.  Most of the info seems to be there already, it's just a
matter of formatting and reordering stuff as needed.