docs(readme): add comprehensive documentation

fixes #11