update compass + improve docs
Update README.md
Merge pull request #446 from glebm/doc-upd

Fix compass, update docs