added comments to API