added comments to the api