Should docs mention that iter/iter_mut access elements in order of insertion (first to last)?

[bzm3r]

Some arenas (e.g. bumpalo) seem to return by most-recent-allocation first. On the other hand, both typed-arena and id-arena return elements in the order of insertion (like a 'normal' Vec).

Am I understanding correctly?

If so, would it make sense to submit a PR to add doc comments on iter/iter_mut that state this order (similar to what the typed-arena docs say for its iter_mut)?

[fitzgen]

Happy to take a PR adding this documentation!