Docs review

Complete review pass of `docs` branch.

Mainly fixing spelling and typos but some more debatable rewordings included so no blind commits please :)