Merge pull request #12256 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

xml/System.Text.Json/JsonSerializerDefaults.xml

@@ -50,15 +50,7 @@
           <para>General-purpose option values. These are the same settings that are applied if a <see cref="T:System.Text.Json.JsonSerializerDefaults" /> member isn't specified.</para>
           <para>For information about the default property values that are applied, see <see href="https://learn.microsoft.com/dotnet/api/system.text.json.jsonserializeroptions#properties">JsonSerializerOptions properties</see>.</para>
         </summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
-
-This option implies that property names are treated as case-sensitive and that "PascalCase" name formatting should be employed.
-
-          ]]></format>
-        </remarks>
+        <remarks>This option implies that property names are treated as case-sensitive and that "PascalCase" name formatting should be employed.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Strict">
@@ -79,7 +71,17 @@ This option implies that property names are treated as case-sensitive and that "
       </ReturnValue>
       <MemberValue>2</MemberValue>
       <Docs>
-        <summary>Specifies that stricter policies should be applied when deserializing from JSON.</summary>
+        <summary>
+          <para>Option values appropriate for strict JSON parsing.</para>
+          <para>This member implies that:</para>
+          <list type="bullet">
+            <item>Unmapped JSON properties aren't allowed.</item>
+            <item>Duplicate JSON properties aren't allowed.</item>
+            <item>Nullable reference type annotations are respected.</item>
+            <item>Required constructor parameters are respected.</item>
+          </list>
+        </summary>
+        <remarks>This option configures stricter deserialization behavior that rejects unmapped or duplicate properties, and enforces both nullable annotations and required constructor parameters.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Web">
@@ -108,19 +110,14 @@ This option implies that property names are treated as case-sensitive and that "
         <summary>
           <para>Option values appropriate to Web-based scenarios.</para>
           <para>This member implies that:</para>
-          <para>- Property names are treated as case-insensitive.</para>
-          <para>- "camelCase" name formatting should be employed.</para>
-          <para>- Quoted numbers (JSON strings for number properties) are allowed.</para>
+          <list type="bullet">
+            <item>Integers must be encoded as small as possible.</item>
+            <item>Property names are treated as case-insensitive.</item>
+            <item>"camelCase" name formatting should be employed.</item>
+            <item>Quoted numbers (JSON strings for number properties) are allowed.</item>
+          </list>
         </summary>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
-
-This option implies that property names are treated as case-insensitive and that "camelCase" name formatting should be employed.
-
-          ]]></format>
-        </remarks>
+        <remarks>This option implies that property names are treated as case-insensitive and that "camelCase" name formatting should be employed.</remarks>
       </Docs>
     </Member>
   </Members>