[skip ci] Clarified and improved (?) some content

I noticed a few items did not render correctly (e.g. the numbered lists) and while fixing these I also added a few minor edits for clarity.

Skipping CI because no code is changed.

Signed-off-by: Mike Thompson mike@openhwgroup.org