A batch of docs changes - all formatting and markup fixes.

There are all markup fixes, mostly table formatting, and some other tweaks to improve compatability with read the docs.