Clarify array ordering documentation

[ahwagner]

@ahwagner great addition. I'm still not fully convinced about how the ordered array is guaranteed. It might be useful to clarify that unless I'm the only one that is missing the technical design behind that.

Originally posted by @larrybabb in #376 (review)

[reece]

Documented in code here and implemented here

However, you're right that it appears to be missing from the docs.

[github-actions]

This issue was marked stale due to inactivity.

[larrybabb]

paritally completed.