Add documentation for CalendarEntity that describes the API, since it is currently ambiguous.
This proposes some specific behaviors around start/date times that may be inconsistent
which are inconsistent wiht some existing integrations as a path forward to making all
integrations have consistent behavior.