move examples into docs directory and update usage examples

With this change, all matplotlib plots in the docs should be being re-plotted
on documentation re-compile.

Closes #78.