[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 | http://www.xs4all.nl/~hanwen
- Re: More documentation, (continued)
- Re: More documentation, Graham Percival, 2003/05/23
- Re: More documentation, Mats Bengtsson, 2003/05/23
- Re: More documentation, Han-Wen Nienhuys, 2003/05/23
- Re: More documentation, Mats Bengtsson, 2003/05/23
- input/ cleanup (was: More documentation), Graham Percival, 2003/05/24
- Re: More documentation, Mats Bengtsson, 2003/05/23
- Re: More documentation,
Han-Wen Nienhuys <=
- Re: More documentation, Graham Percival, 2003/05/26
- Re: More documentation, Han-Wen Nienhuys, 2003/05/26
Re: More documentation, Graham Percival, 2003/05/23