[Top][All Lists]

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

Re: New manual chapter: Putting it all together

From: Graham Percival
Subject: Re: New manual chapter: Putting it all together
Date: Tue, 03 May 2005 00:54:30 -0700

On 29-Apr-05, at 12:44 AM, Han-Wen Nienhuys wrote:

Op do, 28-04-2005 te 17:38 -0700, schreef Graham Percival:
I'm proposing that we add a chapter (to become the new chapter 4) which
demonstrates practical examples of lilypond.  For example,

We went away from commented wordy examples in the tutorial (a long time
ago, I believe for 1.4 or 1.6), because we felt they weren't clear
enough. Perhaps, in this case, the actual documentation of titling,
markup and header should first be revised so it shows more examples and
is clearer?

The response I've gotten (both public and private) is that text markup
definitely needs better docs.  I'll work on that now.  People don't seem
to realize that you can do anything with titles that you can do with
text markup; I'll also make this more obvious.

I'll try to figure out how lyrics work, too, but the archives are down right

  The basic problem with complex examples, is that they're
difficult to read if you don't already know what they say.

I confess that I haven't completely thought out what to do with this
new possible chapter.  I'm pretty sure that we could use another
wordy chapter that explains some of the more complicated lilypond
stuff; I'm not certain whether that should take the form of annotated
short examples, annotated complicated contrived examples, or just
an extension of the existing tutorial (but in a separate chapter for
ease of reading).

If we're going to have a new chapter, IMO it should be included before
2.6.0.  We've rearranged the manual between 2.4 and 2.6, so users will
have to get used to a new chapter numbering scheme; it would be a pity
if 2.6.5 (or whatever) introduced a new chapter which changed the
chapter numbering scheme again.

I'll fix the current text markup stuff and make a more concrete proposal
in a few days.

- Graham

reply via email to

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