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.