update README

upgrade documentation
minor improvements and fixes