Re: GDP: length/page-splitting of subsections

[fiëé visuëlle]

Am 2007-09-10 um 17:00 schrieb Graham Percival:

> - Does anybody _like_ the current layout?  If so, speak up now or  
> forever hold your peace.  :)

No. I always use the online manual in several tabs (the fewer single  
pages, the fewer tabs!) and a Google tab with "site:lilypond.org/ 
doc/...", because it also finds the commands in samples (in contrary  
to the PDF), and often I only need a working sample of usage (the in- 
text samples are often too short or not on topic as I understand it  
or too cluttered - or too simple).

BTW I'd like to see an forever-working URL like http://lilypond.org/ 
doc/current/Documentation/ (instead of the version; should need only  
one symlink; maybe "current-stable" and "current-dev").

> There are two solutions for this:
> 1)  Don't split HTML by into subsections; have one html page per  
> section.
>
> 2)  Merge many subsections.  For example,
> 6.1 Pitches
> 6.1.1 Writing pitches    (includes 6.1.1, 6.1.2, 6.1.3, 6.1.4, and  
> 6.1.5 in the latest proposal)
> 6.1.2 Octaves/jumping pitches   (includes 6.1.6, 6.1.7, and 7.1.8)
> 6.1.3 Rests    (includes 6.1.9 and 6.10)
>
> My preference is for 2 -- I can't believe that users want to see  
> articulations, dynamics, and trills on the same HTML page.  But as  
> I said, we should probably disregard my opinion on this issue.

If you rework the docs anyway, then 2 is good. Otherwise I'd prefer 1.


Greetlings from Lake Constance
---
fiëé visuëlle
Henning Hraban Ramm
http://www.fiee.net
http://angerweit.tikon.ch/lieder/
https://www.cacert.org (I'm an assurer)