Feature apidoc

Documentation changes from @vaibhav-kaushal 
This addressed the #327 issue.