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)
_______________________________________________
lilypond-user mailing list
lilypond-user@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-user
