docs(database): updated and expanded information on entity icons

Updated and expanded documentation on entity icons. Not sure if the cross-references will work outside github.

TODO:

* [x] Update method references to include the class
* [x] Rebase
@Elgg/owners Do we want to include examples to the hook list page? I'm afraid the page will become ridiculously long because there are so many hooks.