Improve docs

Just a bunch of readme changes to help make things clearer