initial commit for api-docs
added better descriptions
update readme