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
* [ ] Rebase
This is still here :)