Sound/Message Use

[TricksterWolf]

So, after a lot of headdesk, I think I figured something out.

variable.c defines const char** angband_sound_name, and z-msg.h contains a corresponding enum of const ints. Neither one of these has any description or documentation, but they have to be in perfect sync for the sounds and messages to work properly. Is this correct?

I have no idea how I was supposed to figure this out by myself, and I'm honestly gobsmacked by all the concrete dependencies between separate files with no documentation. I mean, I expect free software source to be bad, but not nearly this bad, particularly given the length of time Angband has been around. Is there something fundamental I'm missing about how to read and interpret the code base?