Am 22.04.2015 um 20:48 schrieb Federico Bruni:
Hi Abraham
I've been using LilyPond since 6 years.
I think that LilyPond documentation is great. Learning Manual is a
gentle introduction (basically 3 chapters only) for new users and
Notation Reference is a complete reference, well indexed and easy to
search through.
I never found anything better (which is as complex as LilyPond).
I am quite in line with that impression. I don't think the
*documentation* can be *much* better in general. However, there are a
few things that would help new users (I think it would be very good if
some of these could also comment on this thread).
It would be helpful if there were more learning material that has a
slower pace and into more depth at explaining things than the notation
reference. The Learning Manual is very good, but when that's finished
people are not ready to walk alone.
That's what I intend with the tutorials section on the blog, but of
course these posts are only drops in the ocean. But better than nothing.
I could also see something like a community book emerging from these
tutorials, but I'm not sure how well this would work out.
Urs
2015-04-22 17:09 GMT+02:00 Abraham Lee <tisimst.lilyp...@gmail.com
<mailto:tisimst.lilyp...@gmail.com>>:
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?
1. The missing connection between input and output, in other words
something similar to the experience of point-and-click in an editor.
Yes, this is not about structure. I think that structure of NR is Ok.
Also, syntax highlighting would help readability:
https://code.google.com/p/lilypond/issues/detail?id=2578
https://code.google.com/p/lilypond/issues/detail?id=1005
2. no idea
1.
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.
I think that the best way for that kind of users is starting from
screencasts:
http://benlemon.me/blog/music/lilypond/operation-lilypond
What I would find useful is an interactive guide to lilypond syntax:
https://code.google.com/p/lilypond/issues/detail?id=4200
_______________________________________________
lilypond-user mailing list
lilypond-user@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-user
_______________________________________________
lilypond-user mailing list
lilypond-user@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-user