Update Live with current Master

xml/System.Data.Common/DbCommand.xml

@@ -732,7 +732,7 @@
       </Parameters>
       <Docs>
         <param name="behavior">Options for statement execution and data retrieval.</param>
-        <param name="cancellationToken">The token to monitor for cancellation requests.</param>
+        <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
         <summary>Providers should implement this method to provide a non-default implementation for <see cref="Overload:System.Data.Common.DbCommand.ExecuteReader" /> overloads.  
 
  The default implementation invokes the synchronous <see cref="M:System.Data.Common.DbCommand.ExecuteReader" /> method and returns a completed task, blocking the calling thread. The default implementation will return a cancelled task if passed an already cancelled cancellation token. Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.  
@@ -898,7 +898,7 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="0" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netstandard-2.0;netstandard-2.1;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">The token to monitor for cancellation requests.</param>
+        <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
         <summary>This is the asynchronous version of <see cref="M:System.Data.Common.DbCommand.ExecuteNonQuery" />. Providers should override with an appropriate implementation. The cancellation token may optionally be ignored.  
 
  The default implementation invokes the synchronous <see cref="M:System.Data.Common.DbCommand.ExecuteNonQuery" /> method and returns a completed task, blocking the calling thread. The default implementation will return a cancelled task if passed an already cancelled cancellation token.  Exceptions thrown by <see cref="M:System.Data.Common.DbCommand.ExecuteNonQuery" /> will be communicated via the returned Task Exception property.  
@@ -1151,7 +1151,7 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="0" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netstandard-2.0;netstandard-2.1;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">The token to monitor for cancellation requests.</param>
+        <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
         <summary>An asynchronous version of <see cref="Overload:System.Data.Common.DbCommand.ExecuteReader" />, which executes the <see cref="P:System.Data.Common.DbCommand.CommandText" /> against the <see cref="P:System.Data.Common.DbCommand.Connection" /> and returns a <see cref="T:System.Data.Common.DbDataReader" />. This method propagates a notification that operations should be canceled.  
 
  Invokes <see cref="M:System.Data.Common.DbCommand.ExecuteDbDataReaderAsync(System.Data.CommandBehavior,System.Threading.CancellationToken)" />.</summary>
@@ -1202,7 +1202,7 @@
       </Parameters>
       <Docs>
         <param name="behavior">One of the enumeration values that specifies the command behavior.</param>
-        <param name="cancellationToken">The token to monitor for cancellation requests.</param>
+        <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
         <summary>Invokes <see cref="M:System.Data.Common.DbCommand.ExecuteDbDataReaderAsync(System.Data.CommandBehavior,System.Threading.CancellationToken)" />.</summary>
         <returns>A task representing the asynchronous operation.</returns>
         <remarks>
@@ -1362,7 +1362,7 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="0" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netstandard-2.0;netstandard-2.1;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">The token to monitor for cancellation requests.</param>
+        <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
         <summary>This is the asynchronous version of <see cref="M:System.Data.Common.DbCommand.ExecuteScalar" />. Providers should override with an appropriate implementation. The cancellation token may optionally be ignored.  
 
  The default implementation invokes the synchronous <see cref="M:System.Data.Common.DbCommand.ExecuteScalar" /> method and returns a completed task, blocking the calling thread. The default implementation will return a cancelled task if passed an already cancelled cancellation token. Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.  
@@ -1495,7 +1495,7 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="0" FrameworkAlternate="netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">To be added.</param>
+        <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="System.Threading.CancellationToken.None"/>.</param>
         <summary>Asynchronously creates a prepared (or compiled) version of the command on the data source.</summary>
         <returns>A <see cref="P:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
         <remarks>
@@ -1506,7 +1506,7 @@
 
  Data providers that support [asynchronous programming](~/docs/framework/data/adonet/asynchronous-programming.md) should override the default implementation using asynchronous I/O operations.
 
- If the <xref:System.Data.Common.DbCommand.CommandType%2A> property is set to `TableDirect`, `Prepare` does nothing. If <xref:System.Data.Common.DbCommand.CommandType%2A> is set to `StoredProcedure`, the call to `Prepare` should succeed, although it may result in a no-op.  
+ If the <xref:System.Data.Common.DbCommand.CommandType%2A> property is set to `TableDirect`, `PrepareAsync` does nothing. If <xref:System.Data.Common.DbCommand.CommandType%2A> is set to `StoredProcedure`, the call to `PrepareAsync` should succeed, although it may result in a no-op.  
 
  ]]></format>
         </remarks>

xml/System.Data.Common/DbConnection.xml

@@ -294,7 +294,7 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="0" FrameworkAlternate="netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
+        <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="System.Threading.CancellationToken.None"/>.</param>
         <summary>Asynchronously begins a database transaction.</summary>
         <returns>A task whose <see cref="P:System.Threading.Tasks.Task`1.Result" /> property is an object representing the new transaction.</returns>
         <remarks>
@@ -337,7 +337,7 @@
       </Parameters>
       <Docs>
         <param name="isolationLevel">One of the enumeration values that specifies the isolation level for the transaction to use.</param>
-        <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
+        <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="System.Threading.CancellationToken.None"/>.</param>
         <summary>Asynchronously begins a database transaction.</summary>
         <returns>A task whose <see cref="P:System.Threading.Tasks.Task`1.Result" /> property is an object representing the new transaction.</returns>
         <remarks>
@@ -427,7 +427,7 @@
       </Parameters>
       <Docs>
         <param name="databaseName">The name of the database for the connection to use.</param>
-        <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
+        <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="System.Threading.CancellationToken.None"/>.</param>
         <summary>Asynchronously changes the current database for an open connection.</summary>
         <returns>A task representing the asynchronous operation.</returns>
         <remarks>

xml/System.Data.Common/DbTransaction.xml

@@ -138,7 +138,7 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="0" FrameworkAlternate="netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
+        <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="System.Threading.CancellationToken.None"/>.</param>
         <summary>Asynchronously commits the database transaction.</summary>
         <returns>A <see cref="P:System.Threading.Tasks.Task" /> representing the asynchronous operation.</returns>
         <remarks>
@@ -499,7 +499,7 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" Index="0" FrameworkAlternate="netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">A token to cancel the asynchronous operation.</param>
+        <param name="cancellationToken">An optional token to cancel the asynchronous operation. The default value is <see cref="System.Threading.CancellationToken.None"/>.</param>
         <summary>Asynchronously rolls back a transaction from a pending state.</summary>
         <returns>A task representing the asynchronous operation.</returns>
         <remarks>

xml/System.Net/WebUtility.xml

@@ -424,6 +424,8 @@
 
 -   `(` and `)` (opening and closing parentheses)  
 
+ Each ' ' (space) character is converted to a `+` (plus) character.
+
  For example, when embedded in a block of text to be transmitted in a URL, the characters `<` and `>` are encoded as `%3c` and `%3e`.  
 
  The <xref:System.Net.WebUtility.UrlDecode%2A> method reverses the encoding.  

xml/System.Reflection.Metadata/ManifestResource.xml

@@ -50,7 +50,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets the manifest resource attributes.</summary>
-        <value>A bitwise combination of the enumeration values that specify the manifest resource atttributes.</value>
+        <value>A bitwise combination of the enumeration values that specify the manifest resource attributes.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Text.Json/Utf8JsonWriter.xml

@@ -3081,7 +3081,7 @@ Writes the <xref:System.Guid> using the default <xref:System.Buffers.StandardFor
 
 ## Remarks
 
-The property name and value is escaped before writing.
+The property name and value are escaped before writing.
 
           ]]></format>
         </remarks>
@@ -3117,7 +3117,7 @@ The property name and value is escaped before writing.
 
 ## Remarks
 
-The property name and value is escaped before writing.
+The property name and value are escaped before writing.
 
           ]]></format>
         </remarks>
@@ -3153,7 +3153,7 @@ The property name and value is escaped before writing.
 
 ## Remarks
 
-The property name and value is escaped before writing.
+The property name and value are escaped before writing.
 
           ]]></format>
         </remarks>
@@ -3341,7 +3341,7 @@ Writes the <xref:System.Guid> using the default <xref:System.Buffers.StandardFor
 
 ## Remarks
 
-The property name and value is escaped before writing.
+The property name and value are escaped before writing.
 
           ]]></format>
         </remarks>
@@ -3377,7 +3377,7 @@ The property name and value is escaped before writing.
 
 ## Remarks
 
-The property name and value is escaped before writing.
+The property name and value are escaped before writing.
 
           ]]></format>
         </remarks>
@@ -3413,7 +3413,7 @@ The property name and value is escaped before writing.
 
 ## Remarks
 
-The property name and value is escaped before writing.
+The property name and value are escaped before writing.
 
           ]]></format>
         </remarks>
@@ -3604,7 +3604,7 @@ Writes the <xref:System.Guid> using the default <xref:System.Buffers.StandardFor
 
 ## Remarks
 
-The property name and value is escaped before writing.
+The property name and value are escaped before writing.
 
           ]]></format>
         </remarks>
@@ -3641,7 +3641,7 @@ The property name and value is escaped before writing.
 
 ## Remarks
 
-The property name and value is escaped before writing.
+The property name and value are escaped before writing.
 
           ]]></format>
         </remarks>
@@ -3678,7 +3678,7 @@ The property name and value is escaped before writing.
 
 ## Remarks
 
-The property name and value is escaped before writing.
+The property name and value are escaped before writing.
 
           ]]></format>
         </remarks>

xml/System/UInt32.xml

@@ -2312,6 +2312,15 @@
       <Docs>
         <summary>Tries to convert the string representation of a number to its 32-bit unsigned integer equivalent. A return value indicates whether the conversion succeeded or failed.</summary>
         <altmember cref="Overload:System.UInt32.Parse" />
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+
+## Remarks  
+
+ [!INCLUDE[interactive-note](~/includes/csharp-interactive-note-some.md)]
+
+ ]]></format>
+        </remarks>
       </Docs>
     </MemberGroup>
     <Member MemberName="TryParse">
@@ -2434,7 +2443,7 @@
 ## Examples  
  The following example calls the <xref:System.UInt32.TryParse%28System.String%2CSystem.UInt32%40%29> method once for each element in a string array.  
 
- [!code-csharp[System.UInt32.TryParse#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.uint32.tryparse/cs/tryparse1.cs#1)]
+ [!code-csharp-interactive[System.UInt32.TryParse#1](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.uint32.tryparse/cs/tryparse1.cs#1)]
  [!code-vb[System.UInt32.TryParse#1](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.uint32.tryparse/vb/tryparse1.vb#1)]  
 
  ]]></format>