Re: NR appendices D and E are confusing

2025-01-22 Thread Werner LEMBERG
We’d definitely need more opinions, especially from folks like Werner who have worked on the docs/appendices a lot, as well as from users: how do they feel about it? How much do they use which index? >> >> I use Appendix E only. I've now submitted a Merge Request to make the N

Re: NR appendices D and E are confusing

2025-01-06 Thread Werner LEMBERG
> What certainly is confusing is that the navigation bar at the top > and bottom of > https://lilypond.org/doc/v2.25/Documentation/notation/index.html > contains a link "Index" that points to App D and not to App E. I > just discovered it when writing this email, but it seems like a > "bug" that

Re: NR appendices D and E are confusing

2024-12-20 Thread Christopher Heckman
On Fri, Dec 20, 2024 at 5:11 AM Mats Bengtsson wrote: > [...] > On the other hand, using the search box at > the bottom of the left column searches the full set of documentation not > only the current document. > The search box is something else that has bothered me. Since the search box just doe

Re: NR appendices D and E are confusing

2024-12-20 Thread Trevor Bača
On Fri, Dec 20, 2024 at 12:46 PM Werner LEMBERG wrote: > > Two more examples. > > > > An orchestration textbook: > > > > Appendix A: List of Foreign Names for Instruments and Orchestral Terms > > Appendix B: Ranges of Instruments > > Bibliography > > Index > > > > A harmony textbook: > > > > Appe

Re: NR appendices D and E are confusing

2024-12-20 Thread Werner LEMBERG
> Two more examples. > > An orchestration textbook: > > Appendix A: List of Foreign Names for Instruments and Orchestral Terms > Appendix B: Ranges of Instruments > Bibliography > Index > > A harmony textbook: > > Appendix A: Instrumental Ranges and Transpositions > Appendix B: Lead-Sheet Symbo

Re: NR appendices D and E are confusing

2024-12-20 Thread Trevor Bača
On Fri, Dec 20, 2024 at 10:15 AM Simon Albrecht wrote: > On 19.12.24 21:29, Trevor Bača wrote: > > Yes, great. See what everybody thinks. > > > > While people are thinking, what do you think about the idea that > > contents of indices aren't supposed to overlap? (Maybe flip to the > > back of a f

Re: NR appendices D and E are confusing

2024-12-20 Thread Simon Albrecht
On 19.12.24 21:29, Trevor Bača wrote: Yes, great. See what everybody thinks. While people are thinking, what do you think about the idea that contents of indices aren't supposed to overlap? (Maybe flip to the back of a few actual books here to check?) I was giving my opinion. I don’t think t

Re: NR appendices D and E are confusing

2024-12-20 Thread Mats Bengtsson
On 2024-12-19 21:52, Werner LEMBERG wrote: We’d definitely need more opinions, especially from folks like Werner who have worked on the docs/appendices a lot, as well as from users: how do they feel about it? How much do they use which index? I use Appendix E only. While people are thinking,

Re: NR appendices D and E are confusing

2024-12-19 Thread Kieren MacMillan
Hi all, > Do you ever use Appendix D? Or only ever Appendix E? I’m probably not going to be much help here: I haven’t used either of those in so long (like, a decade?!) that just now I had to go look at them to even remember what they actually hold. I use Appendix A from time to time, and App

Re: NR appendices D and E are confusing

2024-12-19 Thread Trevor Bača
On Thu, Dec 19, 2024 at 3:59 PM Kieren MacMillan < kie...@kierenmacmillan.info> wrote: > Hi all, > > > I very much dislike that. We use different fonts (via different > > indexing commands) to provide a clear distinction between concepts and > > commands, and LilyPond's clean naming schemes for p

Re: NR appendices D and E are confusing

2024-12-19 Thread Trevor Bača
On Thu, Dec 19, 2024 at 3:52 PM Werner LEMBERG wrote: > > >> We’d definitely need more opinions, especially from folks like > >> Werner who have worked on the docs/appendices a lot, as well as > >> from users: how do they feel about it? How much do they use which > >> index? > > I use Appendix E

Re: NR appendices D and E are confusing

2024-12-19 Thread Werner LEMBERG
>> I very much dislike that. We use different fonts (via different >> indexing commands) to provide a clear distinction between concepts >> and commands, and LilyPond's clean naming schemes for properties, >> context, engravers, etc., should additionally help a user to find >> the stuff he or she

Re: NR appendices D and E are confusing

2024-12-19 Thread Kieren MacMillan
Hi all, > I very much dislike that. We use different fonts (via different > indexing commands) to provide a clear distinction between concepts and > commands, and LilyPond's clean naming schemes for properties, context, > engravers, etc., should additionally help a user to find the stuff he > or

Re: NR appendices D and E are confusing

2024-12-19 Thread Werner LEMBERG
>> We’d definitely need more opinions, especially from folks like >> Werner who have worked on the docs/appendices a lot, as well as >> from users: how do they feel about it? How much do they use which >> index? I use Appendix E only. > While people are thinking, what do you think about the idea

Re: NR appendices D and E are confusing

2024-12-19 Thread Trevor Bača
On Thu, Dec 19, 2024 at 6:19 AM Simon Albrecht wrote: > Hi Trevor, > > I think you’re not wrong, and it’s entirely fair for you to feel that > way. However, I doubt how common your frustration is. > > On 17.12.24 19:34, Trevor Bača wrote: > > The problem is that the duplication of content between

Re: NR appendices D and E are confusing

2024-12-19 Thread Simon Albrecht
Hi Trevor, I think you’re not wrong, and it’s entirely fair for you to feel that way. However, I doubt how common your frustration is. On 17.12.24 19:34, Trevor Bača wrote: The problem is that the duplication of content between NR-D and NR-E takes a toll on the usability of the docs for many

NR appendices D and E are confusing

2024-12-17 Thread Trevor Bača
Hi folks, When a book has more than one index, the contents of the indices are almost always disjunct. If there's an "Index of music examples" and a "Subject index" in the same book, then the items listed in the first index will almost never appear in the second index, and vice versa. NR-D (Lily