Usage examples other than API docs

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.:

```python
"""
<existing docstring>

Examples
--------

Create a cftime object for a non-standard calendar

>>> cftime.date2num(...)
"""
```