Spot documentation

[Eli Zaretskii]

> Date: Mon, 29 Mar 2010 04:54:15 -0500
> From: "Matthew D. Fuller" <fullermd at over-yonder.net>
> Cc: bazaar at lists.canonical.com
> 
> >  . You tend to over-use "it",
> 
> Pfft.  It's not that bad.  In fact, it's generally agreed that it's
> fine, and there's no reason to disturb it.  It's not like it inhibits
> understanding it.   8-}

All I can say is that it made me go back and re-read previous
paragraphs several times.

> If you have some concrete cases where you find extrapolating
> hits a wall, I'd like to hear them to give me some direction here.

I've described two such cases in my comments.  They are from my
real-life experience as a Bazaar user.

> > Another question is [...] Then, according to perhaps a naive reading
> > of your text, push/pull are still appropriate when the time comes to
> > land the feature from the branch to mainline?
> 
> This is another of those "pulling out implications" cases.  I think
> this will be easiest to address in the planned article showing example
> workflows?

Maybe.  The important thing is to explain them _somewhere_.  Bazaar
allows several usual workflows and quite a few unusual ones.  With the
current level of documentation, all I can do is copycat them, once I
understand the use-case and bump into the same one in my work.  But I
cannot _invent_ such workflows, because the exact effect the various
commands have on the DAG and their limitations are not clear enough.

> Thanks for the feedback!

Thanks for writing that in the first place.