Document how to make / update events

[reinhrst]

Also include internal documentation explaining the timezone issues with the events (under the hood & in Javascript)