annotated README.md