"As we try to make clear, the Learning Manual is intentionally not built for random access. The Notation Reference *is* built for random access."
However it frequently shows up in google search results out of order and the way it is written mean that these pages often don't make sense. Just including a note at the top of all of the pages "this is the learning manual and is intended to be read start to finish" would help clarify that. The absolute fixed set that is relevant to all users is probably smaller than expected as it depends heavily on the application. To give an example, I'm not interested in creating multiple staff arrangements as it isn't relevant to a monophonic instrument. It is possible to write in a way that allows users to skip things they are not interested in by converting the structure into a graph instead of a linier sequence. Pages then have a 'dependency graph', a list of things at the top that the reader needs to know. "Note, you need to understand the following first: ...". This kind of structure also makes it easy to go back and fill in gaps if they become relevant to someone in the future. "I don't see us doing away with the expectation of beginners reading the Learning Manual, but as Kieren said, if you'd like to contribute links that you think would help your understanding, we'd be happy to accept your contributions." I already have more on my plate than I'm able to handle sensibly so I cannot directly make edits, however I am willing to make constructive criticism if I see a problem. _______________________________________________ lilypond-user mailing list lilypond-user@gnu.org https://lists.gnu.org/mailman/listinfo/lilypond-user
