Re: NR appendices D and E are confusing

[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 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?

Best, Simon