reworked Calendar caching, updated docs for calendar api