Doc tweaks

Whenever an example failed, `plot2rst` would fail and halt the Sphinx doc-build. This PR changes the behavior so that a failing example prints a traceback, but the build continues.

Also, clean up a few Sphinx errors.