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
We have a system that takes care of informing about deprecated functions and their replacements. No need to mention here separately.