rewrite of readme.md closes #15