add docblock, update README.md