Fully document public API in README.md