OrderedDictionary page says nothing (!) about ordering

[alex-jitbit]

Type of issue

Missing information

Description

This page say nothing about, well, ordering. Which way items are ordered? Does it preserve the order of insertion? Or something else?

Page URL

https://learn.microsoft.com/en-us/dotnet/api/system.collections.specialized.ordereddictionary?view=net-10.0

Content source URL

https://github.com/dotnet/dotnet-api-docs/blob/main/xml/System.Collections.Specialized/OrderedDictionary.xml

Document Version Independent Id

9bb44bbc-fb69-e341-a6d0-963496847058

Platform Id

3f40af6f-4abf-0670-1671-45f3fad22163

Article author

@dotnet-bot

[gfoidl]

From that page:

The elements of an OrderedDictionary are not sorted by the key, unlike the elements of a SortedDictionary<TKey,TValue> class. You can access elements either by the key or by the index.

But you are right that something like

Does it preserve the order of insertion?

could be added to clarify what's meant.

Do you want to send a PR to add this information?

[alex-jitbit]

I would love to if I knew what the "order" is. I don't cause the docs are missing 😉

[gfoidl]

what the "order" is.

It's the insertion order.