Update JsonSerializerOptions.xml (#10330)

RickDMyers · web-flow · commit 5e37f399fe11 · 2024-10-30T15:34:24.000Z
diff --git a/xml/System.Text.Json/JsonSerializerOptions.xml b/xml/System.Text.Json/JsonSerializerOptions.xml
@@ -686,8 +686,10 @@ For more information, see [How to ignore properties with System.Text.Json](/dotn
         <summary>Gets or sets a value that indicates whether fields are handled during serialization and deserialization.
             The default value is <see langword="false" />.</summary>
         <value>
-          <see langword="true" /> if fields are included during serialization; otherwise, <see langword="false" />.</value>
-        <remarks>To be added.</remarks>
+          <see langword="true" /> if public fields are included during serialization; otherwise, <see langword="false" />.</value>
+        <remarks>This flag only enables serialization for public fields, as is the case for properties.
+                 Private members need to be opted into individually using the <see cref="T:System.Text.Json.Serialization.JsonIncludeAttribute" /> attribute.
+        </remarks>
         <exception cref="T:System.InvalidOperationException">This property is set after serialization or deserialization has occurred.</exception>
       </Docs>
     </Member>
