[Top][All Lists]

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

Re: GDP - Learning Manuall Songs section

From: Graham Percival
Subject: Re: GDP - Learning Manuall Songs section
Date: Wed, 26 Sep 2007 19:53:52 -0700
User-agent: Icedove (X11/20070607)

Eyolf Østrem wrote:
I've been thinking about the Tutorial vs. the rest of the Learning Manual, and I think I finally have a good answer: the Tutorial should cover just enough material to allow people to write simple pieces using the Templates.

Can I come in here with a small request? I agree that the Tutorial
should be limited to what you say, but concerning the templates, I
don't think it should be limited to just being able to copy a template
and filling in the dotted lines. It  would be much more useful if the
templates were lavishly commented (following the principle "give a man
a fish vs. teach him to steal cattle").

The problem with lavish comments in the templates is that after users have used the template once, they'll want to delete the comments every time after that. IMO it's better to explain how to modify the templates in the docs, so that the templates are easier to use.

I'm completely open to expanding the Learning Manual 4.1 Extending the templates, though. Was that section around when you were first using lilypond? If not, please take a look at it now. We could either explain that example more, or give a completely new example or two.

- Graham

reply via email to

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