readme: fill in API documentation