starting to flesh out API in README