feat: add sort method to dictionary

[Michael-Wamae]

• provide a sort method to reorder dictionary

fixes #1314

[baywet]

While this is a first step, I don't think it addresses the core concern: serialization uses the order provided by the document when deserialized. But the consumer want's to control the serialization order.

How do you expect consumers to use this?

[Michael-Wamae]

From the clarification from @darrelmiller we are to provide a Sort() method to reorder all dictionary-based collections. By default we maintain the order provided by the user but in the case there's need to reorder the can use the sort() method on the dictionary

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[darrelmiller]

I did say that, and I do think the Sort method is useful. However, ASPNET have asked for this to be supported in the WriterSettings so they do not have to go around and sort all the collections.

[MaggieKimani1]

Closing as superseded by #2363