Update documentation for converting collections

This clarifies the documentation with regards to converting collection
compared to single element and how this can be used programmatically.

Issue: SPR-11432