Re: New manual chapter: Putting it all together

[Graham Percival]

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
now.

>   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.

Cheers,
- Graham