README.md with API explained. Fixes #9