yes yes yes this is an absolute must

Playing more sophisticated mods requires people know about the different triggers and effects, and you can't really be there to explain every time somebody plays your mod for the first time

I'd go as far as to say that there should be a window dedicated to this instead of something that just appears in chat, like it looks like you imply