DOCS formatting glitches & minor rewording (#1191)

* extra pipe

* missing table header delimiter

* tangled bold and link

* update description for recent versions

* add missing spaces to make linebreaks work

* wording tweak

* revert markup order