Lots of docs fixes

Lots of little things including spelling, sentence clarity, colon vs
full stop consistency and heading capitalisation consistency