On Thu, Dec 19, 2024 at 6:19 AM Simon Albrecht <simon.albre...@mail.de> 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 NR-D and NR-E > takes > > a toll on the usability of the docs for many readers. > > Are you sure it’s “many readers” who can’t get used to the two indices > and find them useful? I don’t have any polling either, but there’s a > reason it is the way it is. > > For me, the most common use case for the indices _by far_ is: hmm, I > want to use music function/command \fooBar and don’t remember the exact > arguments I have to pass along/the order of the arguments/the default > values/… > > So I go to Appendix D and click the link to the reference. Maybe you’re > right and I could just get used to Ctrl+F the command in Appendix E, but > the way it is I feel like Appendix D is quicker and easier to use for > most cases. > > 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? > Hi Simon, 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 love thinking through your way of using Appendix D (the command index). Aspirationally, the idea of a command index is lovely. I think for it to be implemented properly, however, what's supposed to happen is that the main subject index (our Appendix E) should list none of the commands that appear in Appendix D. Then D would be for commands (only) and E would be for everything else. I think maybe you've used Lily for enough years (decades!) that you trust that looking in D will be enough. But I'm pretty certain users with less experience are baffled about why information appears in two places. Trevor. -- Trevor Bača www.trevorbaca.com soundcloud.com/trevorbaca