Automatically port System.Text.Json.JsonProperty (#2881)

* Automatically port System.Text.Json.JsonProperty

* suggestions by Jozkee

Co-Authored-By: David Cantu <[email protected]>

* Update JsonProperty.xml

Author: carlossanlop

xml/System.Text.Json/JsonProperty.xml

@@ -39,8 +39,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The name of this property.</summary>
-        <value>To be added.</value>
+        <summary>Gets the name of this property.</summary>
+        <value>The name of this property.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -63,10 +63,19 @@
         <Parameter Name="utf8Text" Type="System.ReadOnlySpan&lt;System.Byte&gt;" />
       </Parameters>
       <Docs>
-        <param name="utf8Text">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="utf8Text">The UTF-8 encoded text to compare against.</param>
+        <summary>Compares the specified UTF-8 encoded text to the name of this property.</summary>
+        <returns><see langword="true" /> if the name of this property has the same UTF-8 encoding as <paramref name="utf8Text" />; otherwise, <see langword="false" />.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This method is functionally equal to doing an ordinal comparison of `utf8Text` and <xref:System.Text.Json.JsonProperty.Name>, but it can avoid creating the string instance.
+
+          ]]></format>
+        </remarks>
+        <exception cref="T:System.InvalidOperationException">This value's <see cref="T:System.Type" /> is not <see cref="F:System.Text.Json.JsonTokenType.PropertyName" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="NameEquals">
@@ -88,10 +97,19 @@
         <Parameter Name="text" Type="System.ReadOnlySpan&lt;System.Char&gt;" />
       </Parameters>
       <Docs>
-        <param name="text">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="text">The text to compare against.</param>
+        <summary>Compares the specified text as a character span to the name of this property.</summary>
+        <returns><see langword="true" /> if the name of this property matches <paramref name="text" />; otherwise, <see langword="false" />.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This method is functionally equal to doing an ordinal comparison of `text` and <xref:System.Text.Json.JsonProperty.Name>, but it can avoid creating the string instance.
+
+          ]]></format>
+        </remarks>
+        <exception cref="T:System.InvalidOperationException">This value's <see cref="T:System.Type" /> is not <see cref="F:System.Text.Json.JsonTokenType.PropertyName" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="NameEquals">
@@ -113,10 +131,19 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="text">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="text">The text to compare against.</param>
+        <summary>Compares the specified string to the name of this property.</summary>
+        <returns><see langword="true" /> if the name of this property matches <paramref name="text" />; otherwise <see langword="false" />.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This method is functionally equal to doing an ordinal comparison of `text` and <xref:System.Text.Json.JsonProperty.Name>.
+
+          ]]></format>
+        </remarks>
+        <exception cref="T:System.InvalidOperationException">This value's <see cref="T:System.Type" /> is not <see cref="F:System.Text.Json.JsonTokenType.PropertyName" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -157,10 +184,10 @@
         <ReturnType>System.Text.Json.JsonElement</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The value of this property.</summary>
-        <value>To be added.</value>
+        <summary>Gets the value of this property.</summary>
+        <value>The value of this property.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>