added inline docs to each api method