doc: tidy up rst line wrapping, fix some punctuation and typos