readme and doc improvement

Conflicts:
	README.md