Investigate using sphinx's doctest module
Presently we're using python's doctest module in our unit tests, which covers interpretor style examples (those with a '>>>'). However, this doesn't test examples using sphinx's '::' blocks, which we use for most of our examples.
Our unit tests provide test coverage for our tutorials, but they're maintained separately from the documentation itself so they often go stale if we update tutorials.
We should investigate using sphinx's doctest plugin or tricks with the python doctest module to get test coverage of the '::' sphinx blocks. This will likely require us to ask on the python list for ideas...