diff --git a/xml/System.Text.Json/JsonSerializerDefaults.xml b/xml/System.Text.Json/JsonSerializerDefaults.xml
index 713c755e81d..ad775151725 100644
--- a/xml/System.Text.Json/JsonSerializerDefaults.xml
+++ b/xml/System.Text.Json/JsonSerializerDefaults.xml
@@ -50,15 +50,7 @@
General-purpose option values. These are the same settings that are applied if a member isn't specified.
For information about the default property values that are applied, see JsonSerializerOptions properties.
-
-
-
+ This option implies that property names are treated as case-sensitive and that "PascalCase" name formatting should be employed.
@@ -79,7 +71,17 @@ This option implies that property names are treated as case-sensitive and that "
2
- Specifies that stricter policies should be applied when deserializing from JSON.
+
+ Option values appropriate for strict JSON parsing.
+ This member implies that:
+
+ - Unmapped JSON properties aren't allowed.
+ - Duplicate JSON properties aren't allowed.
+ - Nullable reference type annotations are respected.
+ - Required constructor parameters are respected.
+
+
+ This option configures stricter deserialization behavior that rejects unmapped or duplicate properties, and enforces both nullable annotations and required constructor parameters.
@@ -108,19 +110,14 @@ This option implies that property names are treated as case-sensitive and that "
Option values appropriate to Web-based scenarios.
This member implies that:
- - Property names are treated as case-insensitive.
- - "camelCase" name formatting should be employed.
- - Quoted numbers (JSON strings for number properties) are allowed.
+
+ - Integers must be encoded as small as possible.
+ - Property names are treated as case-insensitive.
+ - "camelCase" name formatting should be employed.
+ - Quoted numbers (JSON strings for number properties) are allowed.
+
-
-
-
+ This option implies that property names are treated as case-insensitive and that "camelCase" name formatting should be employed.