update README and docs
Merge pull request #112 from cdeil/docs_update3

small update to README and docs