add comments on API
update