new better docs
prettify & typos
Merge branch 'betterdocs' into develop

Conflicts:
	README.md