Docs review

Complete review pass of `docs` branch.

Mainly fixing spelling and typos but some more debatable rewordings included so no blind commits please :)
want (should have left it as need!)