Documentation fixes.

ReadTheDocs builds pass now, but without images included properly; attempt to fix that.

This also resolves many restructured-text formatting errors reported by sphinx.