Re: GDP - Learning Manuall Songs section

[Graham Percival]

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.

Cheers,
- Graham