adding a bit more API documentation documentation to the README