Improve ngdoc for params and returns.

Split `accepts` arguments into `parameters` and `postData` for
POST/PUT
request.

When `returns` is a single root argument, include its description
in the @return comment.

Fix indentation where it was not consitent and/or caused different
markdown output than intended.