new better docs
prettify & typos
Merge branch 'betterdocs'

Conflicts:
	README.md