improve installation instructions and other docs
Merge branch 'feature/readme' into maint
Merge branch 'maint'

Conflicts:
	README.md