[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: More documentation

From: Han-Wen Nienhuys
Subject: Re: More documentation
Date: Sun, 25 May 2003 19:42:42 +0200

address@hidden writes:
> > document.
> > 
> > Comments? 
> My experience is that as soon as you start dividing a WWW document into
> separate pages, it starts getting more difficult to find the information
> you need. Even though these example files are small and dedicated to a
> specific feature, I fear that it often will be impossible to say that an
> example belongs to a certain section and is completely unrelated to all
> the rest. Personally, I prefer one large WWW page where I can easily do
> full text search or just browse through it to get new ideas of what is
> actually possible to do with the program.
> On the other hand, introducing a number of sections on the same WWW
> page is brilliant idea, of course.

We do the pages in texinfo where you have the choice of putting them
on 1 page or split-up. I think that split-up is valuable for 2 things:

 * less intimidating
 * for users with slow machines (on my 1ghz pc, putting the reg test
  on screen takes a significant amount of time.)

Han-Wen Nienhuys   |   address@hidden   | 

reply via email to

[Prev in Thread] Current Thread [Next in Thread]