Docs structure

From: Vladimir Prus (ghost_at_[hidden])
Date: 2004-12-14 04:08:24

Dave wrote:

> I understand that, but the docs are getting to be a scattered sprawl
> with little or no coherent organization.  It's very unclear where you'd
> go to find out any particular answer you need.  That needs to be not
> only stopped, but repaired.  So I really don't want it to get worse.

I envision the structure to be

1. Tutorial (just nice examples for new users)
2. User documentation. It should document everything, but in a verbose way, 
and without all the details.
3. Reference (has all the details for user visible features, but too dense for 
general users.
4. Extender manual

Opinions welcome.

- Volodya