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