readme, laying out the api