Improve collection API docs

- add keyOptions attribute description which is also part of the result
- add empty line before return codes header
Merge pull request #1154 from yojimbo87/devel

Improve collection API docs