improving API documentation in the README