Improve collection API docs

- add keyOptions attribute description which is also part of the result
- add empty line before return codes header