polish docs and fixes #11