[RFC] proposed user doc for nested trees

[Ian Clatworthy]

Maritza Mendez wrote:

> I read your draft during a particularly boring meeting on Friday. :)

Hope it helped to pass the time. :-)

> 1. This is really well written.  That's a talent.  Thank you for sharing it.

Thanks for the positive feedback. As well as being good for my ego, it's
nice to hear that we're heading in the right direction. If users don't
speak up, it can mean "I silently accept" but it can also mean "you've
confused me so I won't say anything".

> 3. I expect nested to confuse users.  No matter how it is implemented
> someone will complain.  I personally plan to use it a lot and I expect
> to have the manual open at all times.  This is a sophisticated feature
> and the reader needs to pay close attention.  Your draft implies this in
> a few places, and I think it's ok to come right out and say it.

I certainly hope though that you'll only need the manual open the first
few times you use the feature. If not, I'd be concerned that the mental
model was not good enough and still needed some work.

Ian C.