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
