Include code examples for integration and functional tests in docs.

Fixes #1001
@tseaver I'm not sure how to do that when we use `.. automethod:: include`. Would this be the proper syntax?
```
:ref:`include`
```
Also spelling should be "includeme".