README: More fixes in the API documentation