Re: Lily Documentation

[Graham Percival]

address@hidden wrote:
> Which I now see is for 2.8 even though I was running 2.6.  So just off the bat, 
> maybe there should be a pointer (link) to the various versions of the documentation.
> Because it's only now that I 1st realize the documentation wasn't actually 
> intended
> for me.

What, like this?
http://lilypond.org/web/documentation

If you're complaining about scattered docs, I generally suggest looking 
at the latest ones, since I don't update the docs for 2.6 any more.

> But having used this index in an effort to learn the Lily code I have found in 
> almost
> every case there is not enough information there to get the job actually done.  
> For example the very first thing (actually 2nd) is scheme tutorial..

For the purpose of this discussion, I'm only talking about the latest 
online docs, 2.9.10.

- scheme tutorial is tucked away in appendix B.

> But in all honesty it's almost all Greek to me, particularly when the first 
> think
> I might want to do is put the title on a piece.

- tutorial, 2.15 adding titles.  How is that hard to find?

- main docs, 10.2.1 creating titles.

- index, "title" -> 10.2.1.

> Here is a basic template for for a Lilycode Lead Sheet:

- templates are appendix D.

> To be frank the documentation just isn't simple enough.  There is far too much 
> stuff
> to wade through to just enter the name of a piece, and more over as a computer 
> program,
> Lilypond isn't exactly expeditious.  

That's why we have a tutorial.  Do you have any suggestions as to how to 
modify the tutorial?

> I would think that you would start out with a single melody, then go to a duet 
> or
> simple piano piece, and finally an orchestral score.  Figured bass would be a 
> separate
> categories

... so, like the current templates in appendix D?

> Whatever the case, documentation for getting started needs to be based on very 
> useful
> simplistic, but complete templates that have most of the elements of standard 
> music
> composition and notation.  I'm not really interested in how to deal with 7/10 
> time
> or multiple colored instrumental lines on a single staff.   I would rather just 
> like to get 4/4 time when I specify it.  Just (Keep It Simple Stupid.)

... so, like the current templates and the tutorial?

- Graham