Cal doc update[3_ 1_X]

The calendar docs had some typos and the second example was formatted poorly.

backport of #4089