Automatically port System.Text.Encodings (#3151)

* Automatically port System.Text.Encodings

* Fix encoding and endline

* Remove first line

* Update xml/System.Text.Encodings.Web/TextEncoder.xml

* Fix isFinalBlock in EncodeUtf8

* Update xml/System.Text.Encodings.Web/TextEncoder.xml

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

* suggestions by rpetrusha and ahsonkhan

Co-Authored-By: Ron Petrusha <[email protected]>

* Update xml/System.Text.Encodings.Web/TextEncoder.xml

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

Author: 2 people

xml/System.Text.Encodings.Web/TextEncoder.xml

@@ -221,14 +221,22 @@
         <Parameter Name="isFinalBlock" Type="System.Boolean" Index="4" FrameworkAlternate="netcore-3.0" />
       </Parameters>
       <Docs>
-        <param name="source">To be added.</param>
-        <param name="destination">To be added.</param>
-        <param name="charsConsumed">To be added.</param>
-        <param name="charsWritten">To be added.</param>
-        <param name="isFinalBlock">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="source">A source buffer containing the characters to encode.</param>
+        <param name="destination">The destination buffer to which the encoded form of <paramref name="source" /> will be written.</param>
+        <param name="charsConsumed">The number of characters consumed from the <paramref name="source" /> buffer.</param>
+        <param name="charsWritten">The number of characters written to the <paramref name="destination" /> buffer.</param>
+        <param name="isFinalBlock"><see langword="true" /> to indicate there is no further source data that needs to be encoded; otherwise, <see langword="false" />.</param>
+        <summary>Encodes the supplied characters.</summary>
+        <returns>An enumeration value that describes the result of the encoding operation.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The buffers `source` and `destination` must not overlap.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="EncodeUtf8">
@@ -257,8 +265,7 @@
         <param name="utf8Destination">The destination buffer to which the encoded form of <paramref name="utf8Source" /> will be written.</param>
         <param name="bytesConsumed">The number of bytes consumed from the <paramref name="utf8Source" /> buffer.</param>
         <param name="bytesWritten">The number of bytes written to the <paramref name="utf8Destination" /> buffer.</param>
-        <param name="isFinalBlock">
-          <see langword="true" /> if there is further source data that needs to be encoded; otherwise, <see langword="false" />.</param>
+        <param name="isFinalBlock"><see langword="true" /> to indicate there is no further source data that needs to be encoded; otherwise, <see langword="false" />.</param>
         <summary>Encodes the supplied UTF-8 text.</summary>
         <returns>A status code that describes the result of the encoding operation.</returns>
         <remarks>