[WIP] Expand on entity documentation.

Expanding the entity documentation per some discussions I've taken part in on Tent and on the mailing list.

It isn't clear to me if the additional "discovery URIs" are actually entities themselves? If so I can tweak this some.