Re: V2 documentation format: a resolution?

From: Zbynek Winkler (zwin_at_[hidden])
Date: 2004-02-09 11:17:52

Douglas Paul Gregor wrote:
> On Mon, 9 Feb 2004, Reece Dunn wrote:
> 
> 
>>Zbynek Winkler wrote:
>>
>>>I do not think it is a good idea to start with such a huge toc. Maybe a mix
>>>of
>>>condensed version and/or synopsis and/or "how to use this document" would
>>>be
>>>better.
>>
>>If there is a consensus on this, I'll have a look into this, but can't
>>promise anything!
> 
> 
> I personally like seeing the whole ToC, because I rarely read
> top-to-bottom but instead like to pick one small section to read at a
> particular time.

I am not suggesting dropping the toc altogether. I am just saying that IMHO it 
is not a good title page (index.html). There is no reason why there couldn't 
be a separate toc page.

Zbynek

-- 
http://zw.matfyz.cz/ http://robotika.cz/
Faculty of Mathematics and Physics, Charles University, Prague, Czech Republic