I started using Lily for serious maybe a month ago, so I'm what you'd call
new. I find the guide far more useful than the manual (the former seems
more structured around how to do specific things, while the latter seems
much more a general conceptual introduction).

However (and this is something I mentioned on a couple recent message
exchanges), I feel that neither one of them gets me very far past making a
single monolithic file using defaults. There's been a lot of mention (I
imagine rightfully) about how Lily is capable, above all, of making
beautifully engraved scores, and her suitability to managing a text-based,
distributed, and version/change-tracked workflow. All of that sounds
awesome, but I don't see anywhere where that's comprehensively documented.

Let's take my case: I'm transcribing masses from some obscure composer from
the 18th century. There are no extant scores, only the parts (which
ironically works better for Lily's structure). I want these scores to look
their absolute best, and the underlying files to follow the best practices
for structure and organization. I want to put the score and parts alongside
the work of a commercial (read: Sibelius-using) house and have it be
unambiguously a better-looking and standards-conforming result, and be able
to show the incredible flexibility and rigorous flow-control that using the
underlying system can offer.

I don't see anywhere in the reference or the manual where that sort of
comprehensive style guide is presented. I'm thinking something like the
doorstops O'Reilly's uses for documenting, say, HTML. I hate to use the
term (it's already been ruined by bureaucrats), but what I'm really looking
for is a comprehensive "best practices" style guide for how to organize
larger scores.

Urs, I think this would probably dovetail nicely with your efforts to build
a pool of competent engravers, as we would then all be working from the
same style guidelines.

But that's just my use-case. Maybe there are others?

Cheers,

A

On Wed, Apr 22, 2015 at 9:03 PM, Urs Liska <u...@openlilylib.org> wrote:

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

Reply via email to