Very odd English

[DSysdev]

In the page linked below, first line reads:

Json.NET should be used for serialization and deserialization. Provides serialization and deserialization functionality for AJAX-enabled applications.

The wording and punctuation is very odd. It reads like an ad.

Where did this line come from? There is no reason mentioned on why Microsoft would recommend a 3rd party solution over their own.

https://docs.microsoft.com/en-us/dotnet/api/system.web.script.serialization.javascriptserializer

[mairaw]

Thanks for your feedback @DSysdev. I imagine they wanted to recommend Json.NET instead. I'll check.

[Rageking8]

This issue appears to have been fixed some time ago by #3758.

[lextm]

@DSysdev There has been a long story around JSON.NET and you might learn some of that in posts like this.

Microsoft did not only recommend libraries like JSON.NET from the community, but also used many of them in official frameworks (for example, ASP.NET MVC/Razor uses ANTLR). To build a healthy ecosystem around .NET, this is a necessary step to promote good work of others.

Of course when such projects hit the ceiling, Microsoft intervened by

• Hiring JSON.NET author to create the new System.Text.Json.
• Working on a new OpenAPI implementation when Swashbuckle stuck.