Usage examples other than API docs

[TomNicholas]

It would be nice if the documentation included usage examples, as currently the only documentation are the docstrings for the public API. Even just adding examples to each docstring using a new section would be nice, e.g.:

"""
<existing docstring>

Examples
--------

Create a cftime object for a non-standard calendar

>>> cftime.date2num(...)
"""