Doc edits

Wrap long lines, punctuate consistently (full stops)
Wrap long lines, tweak some markup, add some TODO notes, get rid of some sphinx warnings.