Clean up whitespace; add missing words

xml/Microsoft.Extensions.DependencyInjection/HttpClientBuilderExtensions.xml

@@ -611,8 +611,7 @@
             The type of the <see cref="T:System.Net.Http.DelegatingHandler" />. The handler type must be registered as a transient service.
             </typeparam>
         <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" />.</param>
-        <summary>Configures the primary <see cref="T:System.Net.Http.HttpMessageHandler" /> from the dependency injection container
-            for a  named <see cref="T:System.Net.Http.HttpClient" />.</summary>
+        <summary>Configures the primary <see cref="T:System.Net.Http.HttpMessageHandler" /> from the dependency injection container for a named <see cref="T:System.Net.Http.HttpClient" />.</summary>
         <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /> that can be used to configure the client.</returns>
         <remarks>
           <para>

xml/System.Configuration/OverrideMode.xml

@@ -28,7 +28,7 @@
       <format type="text/markdown"><![CDATA[  
 
 ## Remarks  
- Use the <xref:System.Configuration.OverrideMode> enumeration values to set the <xref:System.Configuration.SectionInformation.OverrideMode%2A> property of the <xref:System.Configuration.SectionInformation> class. You set this property in order to programmatically specify override behavior of a configuration element or group. To declaratively set the override behavior for all configuration elements inside a  element, use the `allowOverride` attribute. The <xref:System.Configuration.SectionInformation.OverrideMode%2A> property gives you more granular control over the elements inside a `location` element.  
+ Use the <xref:System.Configuration.OverrideMode> enumeration values to set the <xref:System.Configuration.SectionInformation.OverrideMode%2A> property of the <xref:System.Configuration.SectionInformation> class. You set this property in order to programmatically specify override behavior of a configuration element or group. To declaratively set the override behavior for all configuration elements inside a `location` element, use the `allowOverride` attribute. The <xref:System.Configuration.SectionInformation.OverrideMode%2A> property gives you more granular control over the elements inside a `location` element.  
 
  ]]></format>
     </remarks>

xml/System.Data.Objects/ObjectQuery`1.xml

@@ -769,12 +769,12 @@ The <xref:System.Data.Objects.ObjectQuery`1.OfType*> method can only be applied
         <param name="count">The number of results to skip. This must be either a constant or a parameter reference.</param>
         <param name="parameters">An optional set of query parameters that should be in scope when parsing.</param>
         <summary>Orders the query results by the specified criteria and skips a specified number of results.</summary>
-        <returns>A new <see cref="T:System.Data.Objects.ObjectQuery`1" /> instance that is equivalent to the original instance with both <see href="https://docs.microsoft.com/dotnet/framework/data/adonet/ef/language-reference/order-by-entity-sql">ORDER BY</see> and [SKIP](/dotnet/framework/data/adonet/ef/language-reference/skip-entity-sql) applied.</returns>
+        <returns>A new <see cref="T:System.Data.Objects.ObjectQuery`1" /> instance that is equivalent to the original instance with both <see href="https://docs.microsoft.com/dotnet/framework/data/adonet/ef/language-reference/order-by-entity-sql">ORDER BY</see> and <see href="https://docs.microsoft.com/dotnet/framework/data/adonet/ef/language-reference/skip-entity-sql">SKIP</see> applied.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- The <xref:System.Data.Objects.ObjectQuery%601.Skip%2A> method cannot be used after the <xref:System.Data.Objects.ObjectQuery%601.Top%2A> method. When you use <xref:System.Data.Objects.ObjectQuery%601.Top%2A> after <xref:System.Data.Objects.ObjectQuery%601.Skip%2A>, it functions like the [LIMIT](/dotnet/framework/data/adonet/ef/language-reference/limit-entity-sql) statement of an  clause.
+ The <xref:System.Data.Objects.ObjectQuery%601.Skip%2A> method cannot be used after the <xref:System.Data.Objects.ObjectQuery%601.Top%2A> method. When you use <xref:System.Data.Objects.ObjectQuery%601.Top%2A> after <xref:System.Data.Objects.ObjectQuery%601.Skip%2A>, it functions like the [LIMIT](/dotnet/framework/data/adonet/ef/language-reference/limit-entity-sql) statement of an `ORDER BY` clause.
 
 
 

xml/System.Diagnostics.Tracing/EventListener.xml

@@ -466,7 +466,7 @@
           <format type="text/markdown"><![CDATA[  
 
 ## Remarks  
- The value returned by <xref:System.Diagnostics.Tracing.EventListener.EventSourceIndex%2A> identifies an event source that is suitable for indexing an array. This integer is unique within the application domain. An event listener might find it useful to store additional information about each event source that is connected to it. The value returned by <xref:System.Diagnostics.Tracing.EventListener.EventSourceIndex%2A> allows this extra information to be efficiently stored in a  expandable array such as `List<T>`.  
+ The value returned by <xref:System.Diagnostics.Tracing.EventListener.EventSourceIndex%2A> identifies an event source that is suitable for indexing an array. This integer is unique within the application domain. An event listener might find it useful to store additional information about each event source that is connected to it. The value returned by <xref:System.Diagnostics.Tracing.EventListener.EventSourceIndex%2A> allows this extra information to be efficiently stored in an expandable array such as `List<T>`.  
 
  ]]></format>
         </remarks>

xml/System.DirectoryServices.Protocols/LdapConnection.xml

@@ -608,7 +608,7 @@
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult" /> is null (<see langword="Nothing" /> in Visual Basic).</exception>
         <exception cref="T:System.NotSupportedException">Request is of type DsmlAuthRequest.</exception>
-        <exception cref="T:System.DirectoryServices.Protocols.LdapException">The error code returned by LDAP does not map to a  the <see cref="T:System.DirectoryServices.Protocols.ResultCode" /> enumeration error code.</exception>
+        <exception cref="T:System.DirectoryServices.Protocols.LdapException">The error code returned by LDAP does not map to a  <see cref="T:System.DirectoryServices.Protocols.ResultCode" /> enumeration error code.</exception>
         <exception cref="T:System.DirectoryServices.Protocols.DirectoryOperationException">The server returned a <see cref="T:System.DirectoryServices.Protocols.DirectoryResponse" /> object with an error.</exception>
       </Docs>
     </Member>

xml/System.DirectoryServices/DirectorySynchronization.xml

@@ -59,7 +59,7 @@ fmt.Serialize(myStream, src.DirectorySynchronization);
 myStream.Close();  
 
 
-// At some point in time, we wake up and read by de-serializing the dirSync cookie,   
+// At some point in time, we wake up and read by deserializing the dirSync cookie,   
 // and resume the dirSync   
 FileStream myStream = FileCreate("dirsync.data");  
 BinaryFormatter fmt = new BinaryFormatter();  

xml/System.Numerics/Vector`1.xml

@@ -2211,7 +2211,7 @@ The type `T` can be any of the following numeric types:
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="format">A  or  that defines the format of individual elements.</param>
+        <param name="format">The format of individual elements.</param>
         <summary>Returns the string representation of this vector using the specified format string to format individual elements.</summary>
         <returns>The string representation of the current instance.</returns>
         <remarks>
@@ -2272,7 +2272,7 @@ The type `T` can be any of the following numeric types:
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <param name="format">A  or  that defines the format of individual elements.</param>
+        <param name="format">The format of individual elements.</param>
         <param name="formatProvider">A format provider that supplies culture-specific formatting information.</param>
         <summary>Returns the string representation of this vector using the specified format string to format individual elements and the specified format provider to define culture-specific formatting.</summary>
         <returns>The string representation of the current instance.</returns>

xml/System.Printing.IndexedProperties/PrintSystemTypeProperty.xml

@@ -172,7 +172,7 @@
       <Docs>
         <param name="attribRef">A pointer to the <see cref="T:System.Printing.IndexedProperties.PrintSystemTypeProperty" /> that is converted.</param>
         <summary>Provides implicit conversion to a <see cref="T:System.Type" /> value from a pointer to a <see cref="T:System.Printing.IndexedProperties.PrintSystemTypeProperty" />.</summary>
-        <returns>A converted Type value form a  PrintSystemTypeProperty object.</returns>
+        <returns>The converted type.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Resources/ResourceManager.xml

@@ -1678,7 +1678,7 @@ csc GetStream.cs /resource:AppResources.resources
       </Parameters>
       <Docs>
         <param name="name">The name of a resource.</param>
-        <param name="culture">An  object that specifies the culture to use for the resource lookup. If <paramref name="culture" /> is <see langword="null" />, the culture for the current thread is used.</param>
+        <param name="culture">The culture to use for the resource lookup. If <paramref name="culture" /> is <see langword="null" />, the culture for the current thread is used.</param>
         <summary>Returns an unmanaged memory stream object from the specified resource, using the specified culture.</summary>
         <returns>An unmanaged memory stream object that represents a resource.</returns>
         <remarks>

xml/System.Runtime.Caching.Configuration/MemoryCacheElement.xml

@@ -19,7 +19,7 @@
       <format type="text/markdown"><![CDATA[  
 
 ## Remarks  
- The <xref:System.Runtime.Caching.Configuration.MemoryCacheElement> class defines a  element that you can use to configure the cache. Multiple instances of the <xref:System.Runtime.Caching.MemoryCache> class can be used in a single application. Each `memoryCache` element in the configuration file can contain settings for a named <xref:System.Runtime.Caching.MemoryCache> instance.  
+ The <xref:System.Runtime.Caching.Configuration.MemoryCacheElement> class defines a `memoryCache` element that you can use to configure the cache. Multiple instances of the <xref:System.Runtime.Caching.MemoryCache> class can be used in a single application. Each `memoryCache` element in the configuration file can contain settings for a named <xref:System.Runtime.Caching.MemoryCache> instance.  
 
  The `memoryCache` element requires a `namedCaches` child element. To define named configurations of the cache in addition to the default configuration, you can add `namedCaches` elements. For more information about how to add named cache configurations, see [&lt;namedCaches&gt; Element (Cache Settings)](/dotnet/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings).  
 

xml/System.Runtime.InteropServices/RuntimeEnvironment.xml

@@ -259,7 +259,6 @@
           <format type="text/markdown"><![CDATA[  
 
 ## Remarks
- This method is similar to calling the  method on the  interface that represents this runtime.  
 
 The following table shows the supported combinations for `clsid` and `riid`.  
 

xml/System.Runtime.Loader/AssemblyDependencyResolver.xml

@@ -71,7 +71,8 @@
       <Docs>
         <param name="componentAssemblyPath">The path to the component or plugin's managed entry point.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Runtime.Loader.AssemblyDependencyResolver" /> class with a path to a component's assembly.</summary>
-        <remarks>`componentAssemblyPath` can be a relative or an absolute path. The assembly must have an accompanying deps.json file in the same directory that describes the assembly's dependencies. This file is output during the build process.</remarks>
+        <remarks>
+          <paramref name="componentAssemblyPath" /> can be a relative or an absolute path. The assembly must have an accompanying deps.json file in the same directory that describes the assembly's dependencies. This file is output during the build process.</remarks>
       </Docs>
     </Member>
     <Member MemberName="ResolveAssemblyToPath">

xml/System.Security.Cryptography.Pkcs/Pkcs9SigningTime.xml

@@ -27,7 +27,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>The <see cref="T:System.Security.Cryptography.Pkcs.Pkcs9SigningTime" /> class defines the signing date and time of a signature. A <see cref="T:System.Security.Cryptography.Pkcs.Pkcs9SigningTime" /> object can  be used as an authenticated attribute of a <see cref="T:System.Security.Cryptography.Pkcs.CmsSigner" /> object when an authenticated date and time are to accompany a digital signature.</summary>
+    <summary>Defines the signing date and time of a signature. A <see cref="T:System.Security.Cryptography.Pkcs.Pkcs9SigningTime" /> object can be used as an authenticated attribute of a <see cref="T:System.Security.Cryptography.Pkcs.CmsSigner" /> object when an authenticated date and time are to accompany a digital signature.</summary>
     <remarks>
       <format type="text/markdown"><![CDATA[  
 

xml/System.Security.Policy/PublisherMembershipCondition.xml

@@ -61,7 +61,7 @@
 ## Remarks  
  A code assembly satisfies a publisher membership condition if that code is signed by the specified software publisher.  
 
- By default, code access security (CAS) does not check for <xref:System.Security.Policy.Publisher> evidence. Unless your computer has a custom code group based on the <xref:System.Security.Policy.PublisherMembershipCondition> class, you can improve performance by bypassing Authenticode signature verification. This is accomplished by configuring the runtime to not provide <xref:System.Security.Policy.Publisher> evidence for CAS. For more information about how to configure this option and which applications can use it, see the  element.  
+ By default, code access security (CAS) does not check for <xref:System.Security.Policy.Publisher> evidence. Unless your computer has a custom code group based on the <xref:System.Security.Policy.PublisherMembershipCondition> class, you can improve performance by bypassing Authenticode signature verification. This is accomplished by configuring the runtime to not provide <xref:System.Security.Policy.Publisher> evidence for CAS. For more information about how to configure this option and which applications can use it, see the \<generatePublisherEvidence> element.  
 
  ]]></format>
     </remarks>

xml/System.ServiceModel.Security/ImpersonateOnSerializingReplyMessageProperty.xml

@@ -169,7 +169,7 @@
         <param name="property">When this method returns, contains the <see cref="T:System.ServiceModel.Security.ImpersonateOnSerializingReplyMessageProperty" /> property extracted from the message.</param>
         <summary>Gets the <see cref="T:System.ServiceModel.Security.ImpersonateOnSerializingReplyMessageProperty" /> property from the specified message.</summary>
         <returns>
-          <see langword="true" /> if the  property was found; otherwise, <see langword="false" />.</returns>
+          <see langword="true" /> if the <see cref="T:System.ServiceModel.Security.ImpersonateOnSerializingReplyMessageProperty" /> property was found; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -197,7 +197,7 @@
         <param name="property">When this method returns, contains the <see cref="T:System.ServiceModel.Security.ImpersonateOnSerializingReplyMessageProperty" /> property extracted from the message.</param>
         <summary>Gets the <see cref="T:System.ServiceModel.Security.ImpersonateOnSerializingReplyMessageProperty" /> property from the specified <see cref="T:System.ServiceModel.Channels.MessageProperties" /> object.</summary>
         <returns>
-          <see langword="true" /> if the  property was found; otherwise, <see langword="false" />.</returns>
+          <see langword="true" /> if the <see cref="T:System.ServiceModel.Security.ImpersonateOnSerializingReplyMessageProperty" /> property was found; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Speech.Synthesis.TtsEngine/FragmentState.xml

@@ -103,7 +103,7 @@
 
 -   If negative a member of the <xref:System.Speech.Synthesis.TtsEngine.EmphasisBreak> enumeration  
 
- If the <xref:System.Speech.Synthesis.TtsEngine.TtsEngineAction> value specified by the `action` argument is not <xref:System.Speech.Synthesis.TtsEngine.TtsEngineAction.Silence>`emphasis` argument must be of type <xref:System.Speech.Synthesis.TtsEngine.EmphasisWord>.  
+ If the <xref:System.Speech.Synthesis.TtsEngine.TtsEngineAction> value specified by the `action` argument is not <xref:System.Speech.Synthesis.TtsEngine.TtsEngineAction.Silence>, the `emphasis` argument must be of type <xref:System.Speech.Synthesis.TtsEngine.EmphasisWord>.  
 
  If the value of the `duration` argument and The <xref:System.Speech.Synthesis.TtsEngine.Prosody.Duration%2A> property or the <xref:System.Speech.Synthesis.TtsEngine.Prosody> object specified by the `prosody` argument differ, the value on the <xref:System.Speech.Synthesis.TtsEngine.Prosody> object is used.  
 

xml/System.Timers/Timer.xml

@@ -92,7 +92,7 @@
  For a list of default property values for an instance of <xref:System.Timers.Timer>, see the <xref:System.Timers.Timer.%23ctor%2A> constructor.  
 
 > [!TIP]
->  Be aware that .NET includes four classes named `Timer`, each of which offers different functionality:  
+> .NET includes four classes named `Timer`, each of which offers different functionality:  
 >   
 > - <xref:System.Timers.Timer?displayProperty=nameWithType> (this topic): fires an event at regular intervals. The class is intended for use as a server-based or service component in a multithreaded environment; it has no user interface and is not visible at runtime.  
 > - <xref:System.Threading.Timer?displayProperty=nameWithType>: executes a single callback method on a thread pool thread at regular intervals. The callback method is defined when the timer is instantiated and cannot be changed. Like the <xref:System.Timers.Timer?displayProperty=nameWithType> class, this class is intended for use as a server-based or service component in a multithreaded environment; it has no user interface and is not visible at runtime.  

xml/System.Xaml/XamlMember.xml

@@ -45,9 +45,7 @@
  You should not construct a <xref:System.Xaml.XamlMember> that has a value of `true` for <xref:System.Xaml.XamlMember.IsUnknown%2A> unless your implementation can handle the exceptions from <xref:System.Xaml.XamlObjectWriter>, or you have other ways to adjust the <xref:System.Xaml.XamlObjectWriter> behavior. For example, one or more of the following might be true of your implementation:  
 
 -   The XAML schema context is available later.
-
 -   You use a member invoker pattern.
-
 -   You deliberately override <xref:System.Xaml.XamlObjectWriter.WriteStartMember%2A?displayProperty=nameWithType> in a custom XAML writer.
 
  ]]></format>

xml/System/MemberAccessException.xml

@@ -69,7 +69,7 @@
 
  <xref:System.Reflection.MethodBase.Invoke%2A> of the <xref:System.Reflection> classes, <xref:System.Reflection.FieldInfo.GetValue%2A> of the <xref:System.Reflection.FieldInfo> class, and <xref:System.Delegate.DynamicInvoke%2A> of the <xref:System.Delegate> class.  
 
- Apps compiled by using the .NET Native tool chain may throw a  exception at runtime.  is an internal-only exception type derived from <xref:System.MemberAccessException>. The exception indicates that metadata needed for the successful execution of an app is not present at runtime. You should not use a `try`/`catch` block to handle the exception. Instead, you should determine what metadata is missing and modify your app's  to ensure that it is present at runtime.  
+ Apps compiled by using the .NET Native tool chain may throw a [MissingRuntimeArtifactException](/windows/uwp/dotnet-native/missingruntimeartifactexception-class-net-native) exception at run time. `MissingRuntimeArtifactException` is an internal-only exception type derived from <xref:System.MemberAccessException>. The exception indicates that metadata needed for the successful execution of an app is not present at run time. You should not use a `try`/`catch` block to handle the exception. Instead, you should determine what metadata is missing and modify your app's runtime directives file to ensure that it is present at run time.  
 
  <xref:System.MemberAccessException> uses the HRESULT COR_E_MEMBERACCESS, that has the value 0x8013151A.