Improve JSON descriptions

[gewarren]

Contributes to dotnet/docs#21067.

[opbld34]

Docs Build status updates of commit cc9dd7e:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/System.Net.Http.Json/HttpClientJsonExtensions.xml	✅Succeeded	View
xml/System.Net.Http.Json/HttpContentJsonExtensions.xml	✅Succeeded	View
xml/System.Text.Json/JsonSerializerDefaults.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching in the Docs contributor and Admin Guide
• See the frequently asked questions
• Post your question in the Docs support channel

[opbld32]

Docs Build status updates of commit 2bad84c:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/System.Net.Http.Json/HttpClientJsonExtensions.xml	✅Succeeded	View
xml/System.Net.Http.Json/HttpContentJsonExtensions.xml	✅Succeeded	View
xml/System.Text.Json/JsonSerializerDefaults.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching in the Docs contributor and Admin Guide
• See the frequently asked questions
• Post your question in the Docs support channel

[layomia]

Not sure that we have to mention this. If we do, what about all the other options e.g. ReadCommentHandling, DictionaryKeyPolicy etc.

If the intention is to contrast with Web options, maybe we should add that quoted numbers (JSON strings) are not allowed.

[gewarren]

I was mainly just reformatting the existing text. But it seems like it would be helpful to list out all the options it prescribes?

[gewarren]

@tdykstra What do you think?

[layomia]

I think we should link to here: https://docs.microsoft.com/en-us/dotnet/api/system.text.json.jsonserializeroptions?view=net-5.0#properties since this ideally should list what the default value for each property is.

[tdykstra]

Agree with @layomia proposal, in which case explicitly mentioning property naming defaults isn't necessary here.

[gewarren]

Interestingly, remarks for enum members seem to be bogus (ignored). I'll double check that that behavior is by design.

https://review.docs.microsoft.com/en-us/dotnet/api/system.text.json.jsonserializerdefaults?view=net-5.0&branch=pr-en-us-5007

[opbld31]

Docs Build status updates of commit 16ac284:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/System.Net.Http.Json/HttpClientJsonExtensions.xml	✅Succeeded	View
xml/System.Net.Http.Json/HttpContentJsonExtensions.xml	✅Succeeded	View
xml/System.Text.Json/JsonSerializerDefaults.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching in the Docs contributor and Admin Guide
• See the frequently asked questions
• Post your question in the Docs support channel

[opbld32]

Docs Build status updates of commit 43af631:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/System.Net.Http.Json/HttpClientJsonExtensions.xml	✅Succeeded	View
xml/System.Net.Http.Json/HttpContentJsonExtensions.xml	✅Succeeded	View
xml/System.Text.Json/JsonSerializerDefaults.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching in the Docs contributor and Admin Guide
• See the frequently asked questions
• Post your question in the Docs support channel

[opbld31]

Docs Build status updates of commit 3405cf8:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/System.Net.Http.Json/HttpClientJsonExtensions.xml	✅Succeeded	View
xml/System.Net.Http.Json/HttpContentJsonExtensions.xml	✅Succeeded	View
xml/System.Text.Json/JsonSerializerDefaults.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching in the Docs contributor and Admin Guide
• See the frequently asked questions
• Post your question in the Docs support channel