[calendar/docs] Update the docs for calendar / events to reflect the latest api.

Summary: New docs. Might need to be updated again if we decide on other api changes discussed.

Test Plan: Read them and make sure they all make sense.

Reviewers: bengotow

Reviewed By: bengotow

Differential Revision: https://review.inboxapp.com/D389