add a comment clarifying the importance of iteration order