feat: change all collections to ordered collections

[Michael-Wamae]

• change all collections to ordered collections
  Fixes Change all collections to ordered collections #2329

[sonarqubecloud]

Quality Gate failed

Failed conditions
66.4% Coverage on New Code (required ≥ 80%)

See analysis details on SonarQube Cloud

[darrelmiller]

@Michael-Wamae Sorry for the randomization, @baywet and I have had some intense negotiations and have come to a compromise.

Facts:

• Emitting collections in a non-deterministic order is a problem for customers that we have had multiple requests to fix.
• Swashbuckle has the ability for developers to control the ordering of collections
• ASPNET would like to sort collections alphabetically
• OrderedDictionary has performance cost and is not supported in downrev versions of .NET
• No customer has asked for us to maintain the order of the input document (Darrel does not count as a customer)
• Future versions of .NET will support using the collection initialization syntax for interfaces

Compromise:

• Go back to using Dictionary during reading to avoid perf costs and need to implement a custom implementation for downrev .net
• Wait for customer signal to implement maintaining of input order
• Change the API surface area back to IDictionary to allow future implementations to use OrderedDictionary without it being a breaking change and continue allowing Swashbuckle customers to provide custom ordering
• IDictionary will require customers to explicitly provide the type until .NET adds implicit support
• Add WriterSettings option to enable sorting using a comparer to meet the need for deterministic ordering

Sorry again for sending you down the wrong path. Hopefully, what we have learned here will reduce future maintenance work.

/cc @baywet