Update docs

Mainly formatting and grammar but also some new info.