Very, very few users will ever write plugins, so why make them have to parse through a document where a large percentage of the items don't pertain to them?
Just my thoughts, you don't need to agree.

Personally, I'd like a "quick reference", with just a list as you've posted in those previous emails. I'm going to copy those two emails and print them out.