Re: More documentation

[Han-Wen Nienhuys]

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   |   http://www.xs4all.nl/~hanwen