Improve documentation with regard to returning multiple elements from a repository method.

[schauder]

See also #2535

Explain to consider which methods to expose at all
Explain redeclaration and potential introduction of a project-specific base interface with the required customizations
Explain Streamable utility as conversion utility