docs_requirements and higher level readme
Longer getting started guide
formatting fix
typos, grammar, clarity