[RFC] proposed user doc for nested trees

[John Arbash Meinel]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Aaron Bentley wrote:
> Martin Pool wrote:
>> 2009/5/12 Aaron Bentley <aaron at aaronbentley.com>:
> 
>> If this sounds grumpy or terse, and plead the poor excuse that I'm
>> trying to get it out before leaving for Allhands in the hope it will
>> help get any remaining issues cleared up and you unblocked to write
>> something cool.
> 
> Well, I don't have any similar excuse.  If I sound grumpy, it's because
> I am.
> 
>>> I think it makes a lot more sense to start with the NestedTreesDesign
>>> document which I updated at your request, and look at user-level
>>> documentation afterward, as a supplement to it.
>> OK.  Most of these questions are things we do need to address in the
>> user documentation, in my opinion.  It's true it does serve two
>> purposes at the moment by both moving towards being actual
>> documentation and also being a framework for discussion.
> 
> I don't agree that it should serve as a framework for discussion.  I
> don't think we can describe the UI in detail until we've come to grips
> with the design.

I think it is important to have fairly well defined use cases of what
you *want* to support, so that you have an idea of whether your design
actually accomplishes what you set out to do.

Whether that is just another section in the design doc, or a separate doc...

John
=:->

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAkoLR+AACgkQJdeBCYSNAAN0YwCfSbGfwOJcHu7Li14G+rAenEH2
nIAAnjrFMvJThiXSQzEHq+krCbg2ooOY
=byXH
-----END PGP SIGNATURE-----