I added a sentence to the for-statement docu to warn about iterating over un-sorted lists.
For most people this might be obvious but might help some.
I've improved documentation of the "for" loop in the git branch "topic/dnthayer/doc-improvements".
Duplicate of BIT-1520.