Re: 36 doc edits (NR1 & NR2)

[Trevor Bača]

On Mon, Dec 16, 2024 at 6:17 PM Dan Eble <nine.fierce.ballads@gmail.com>
wrote:

> On 2024-12-16 17:57, Trevor Bača wrote:
> > On Mon, Dec 16, 2024 at 5:32 PM Dan Eble <nine.fierce.ballads@gmail.com
> > <mailto:nine.fierce.ballads@gmail.com>> wrote:
>
> >     I am the author of this example.  I used inclusion to cut out
> material
> >     that I thought was not essential to make my point.  I question
> whether
> >     it is important for all examples to be complete, as you seem to
> suggest.
> >
> >     If I am wrong about that, we could include the full song verbatim.
> >
> >
> > Using an \include is a great way to simplify the example, it's just that
> > the file ("old-hundredth-example.ly <http://old-hundredth-example.ly>")
> > doesn't seem to exist in my LilyPond install. (I was testing everything
> > under 2.25.19.) Is it possible that the file somehow just wasn't bundled
> > with 2.25.19?
>
> Distributing the file with LilyPond was not intended.  I don't think it
> would make sense either.
>
>  > I think we should definitely preserve the example, it's
>  > just that users need to be able to compile code themselves with their
>  > local LilyPond to study it.
>
> I'm not sure how to satisfy this desire without bloating LilyPond or the
> Notation Reference.  Do we have techniques for linking from the NR to
> supplementary material?
>

Oh, I see. If anyone else has a solid opinion about this, they can make the
decision. For my part, looking at the music of the psalm (lovely, btw) I
certainly think it would be ok to just include all of the musical input
inline with the example, just like all the other examples in the NR. There
are a number of examples in the NR with considerably more notes, so to
speak, so it seems like it would be fine to go ahead and include the note
entry

But I do think that it's important for users to be able to have access (one
way or another) to the note entry for every example in the NR, and the
psalm in your example is a particularly good example as to why: it took me
several *days* to figure out what was going on with the settings to
caesuraType (and friends) when I finally went through all the examples
earlier this year! It's not at all obvious how those settings work (when
you first start reading about them), so the ability to throw the example
code in a test file and move things around is super helpful.


-- 
Trevor Bača
www.trevorbaca.com
soundcloud.com/trevorbaca