fixing comments and refining the API methods that I added