more minor doc changes

fix some formatting, phrasing
formatting improvements for headings