Re: How do new users feel about LilyPond's documentation?

[Knute Snortum]

LilyPond has a great glossary, but I'd like to see cross-references back to the Notation manual.  For instance, I might lookup "grace note" which gives me acciaccatura, but there is no link to the Notation manual.

Knute Snortum

(via Gmail)

On Wed, Apr 22, 2015 at 8:09 AM, Abraham Lee <address@hidden> wrote:

All,

I've been thinking about this a lot lately, even going so far as to create my own "Quick Start" tutorials for new users, but I can only go so far in my own head. I really have two questions that I keep wondering about:

1. What is the thing you (especially new users) like the least about LilyPond's documentation structure?
2. If you could have the same documentation structure as found in another notation program, which program is it? Or put another way: Is there a notation program out there that has a documentation structure you like?
   

I'm asking this because I'm trying to determine how we in the 'Pond can make it easier for new users to jump in with both feet instead of dipping a toe and getting scared of the deep.

I may be over-thinking this, but I keep getting the feeling that people are scared of using LilyPond partially because the documentation, though deep and detailed, is a little too deep and technical for new users who are familiar with a GUI program and less familiar with programming.

Any thoughts? I think I'm mostly interested in comments related to the *Learning* and *Notation* manuals, but comments about the others are welcome, too.

I can't say that I'm proposing any massive changes to the documentation, but I'd like to know if there's something else that would be more new user-friendly.

- Abraham

_______________________________________________
lilypond-user mailing list
address@hidden
https://lists.gnu.org/mailman/listinfo/lilypond-user