diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml b/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml
index 8cf3aa27e2c..f5f44a4d845 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml
@@ -26,15 +26,7 @@
The object type to serialize or deserialize.
Provides serialization metadata about an object type with constructors, properties, and fields.
-
-
-
+ This API is intended for use by the output of the System.Text.Json source generator and should not be called directly.
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml b/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml
index eca6e84267d..338496cab0c 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml
@@ -22,15 +22,7 @@
Provides information about a constructor parameter required for JSON deserialization.
-
-
-
+ This API is intended for use by the output of the System.Text.Json source generator and should not be called directly.
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonPropertyInfo.xml b/xml/System.Text.Json.Serialization.Metadata/JsonPropertyInfo.xml
index 8397803ebe7..1b93bade3a8 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonPropertyInfo.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonPropertyInfo.xml
@@ -16,15 +16,7 @@
Provides JSON serialization-related metadata about a property or field.
-
-
-
+ To be added.
@@ -177,10 +169,21 @@ The current or , the value of this property will be mapped from annotations.
- For contracts using , the value of this property will also map from properties that have the modifier, unless deserialization uses a constructor that populates all required properties and that has .
- keyword is currently not supported in contracts.
+
+ or , the value of this property is mapped from annotations.
+
+For contracts that use , the value of this property is also mapped from properties that have the `required` modifier, unless deserialization uses a constructor that populates all required properties and has .
+
+The `required` keyword is currently not supported in contracts.
+
+]]>
+
The instance has been locked for further modification.
+ Required properties
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo.xml b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo.xml
index 6ebcd74529f..a2dbe157d2c 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonTypeInfo.xml
@@ -20,15 +20,7 @@
Provides JSON serialization-related metadata about a type.
-
-
-
+ To be added.