diff --git a/xml/System.Text.Json.Serialization/JsonNumberHandling.xml b/xml/System.Text.Json.Serialization/JsonNumberHandling.xml
index e1fee5834c2..49572c04410 100644
--- a/xml/System.Text.Json.Serialization/JsonNumberHandling.xml
+++ b/xml/System.Text.Json.Serialization/JsonNumberHandling.xml
@@ -21,7 +21,7 @@
   </Attributes>
   <Docs>
     <summary>Determines how <see cref="T:System.Text.Json.JsonSerializer" /> handles numbers when serializing and deserializing.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>The behavior of <see cref="F:System.Text.Json.Serialization.JsonNumberHandling.WriteAsString"/> and <see cref="F:System.Text.Json.Serialization.JsonNumberHandling.AllowNamedFloatingPointLiterals"/> is not defined by the JSON specification. Altering the default number handling can potentially produce JSON that cannot be parsed by other JSON implementations.</remarks>
   </Docs>
   <Members>
     <Member MemberName="AllowNamedFloatingPointLiterals">
@@ -43,7 +43,7 @@
       <MemberValue>4</MemberValue>
       <Docs>
         <summary>The "NaN", "Infinity", and "-Infinity" <see cref="F:System.Text.Json.JsonTokenType.String" /> tokens can be read as floating-point constants, and the <see cref="T:System.Single" /> and <see cref="T:System.Double" /> values for these constants will be written as their corresponding JSON string representations.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>This field is not defined by the JSON specification. Altering the default number handling can potentially produce JSON that cannot be parsed by other JSON implementations.</remarks>
       </Docs>
     </Member>
     <Member MemberName="AllowReadingFromString">
@@ -109,7 +109,7 @@
       <MemberValue>2</MemberValue>
       <Docs>
         <summary>Numbers will be written as JSON strings (with quotes), not as JSON numbers.</summary>
-        <remarks>To be added.</remarks>
+        <remarks>This field is not defined by the JSON specification. Altering the default number handling can potentially produce JSON that cannot be parsed by other JSON implementations.</remarks>
       </Docs>
     </Member>
   </Members>