From eb4b8f1174fcc192744e2ff5a78e13e3b6978d47 Mon Sep 17 00:00:00 2001
From: Min Huang <huangmin@microsoft.com>
Date: Thu, 17 Nov 2022 11:44:21 +0800
Subject: [PATCH 1/2] Workaround for
 https://dev.azure.com/ceapex/Engineering/_workitems/edit/738082

---
 .../CommandLineConfigurationExtensions.xml                    | 4 ++--
 xml/Microsoft.Extensions.Options/IOptionsMonitor`1.xml        | 2 +-
 xml/Microsoft.Extensions.Options/IOptionsSnapshot`1.xml       | 2 +-
 xml/Microsoft.Extensions.Options/OptionsManager`1.xml         | 2 +-
 xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml  | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/xml/Microsoft.Extensions.Configuration/CommandLineConfigurationExtensions.xml b/xml/Microsoft.Extensions.Configuration/CommandLineConfigurationExtensions.xml
index a4f0318f66b..7be6d61a7e6 100644
--- a/xml/Microsoft.Extensions.Configuration/CommandLineConfigurationExtensions.xml
+++ b/xml/Microsoft.Extensions.Configuration/CommandLineConfigurationExtensions.xml
@@ -94,7 +94,7 @@
         <param name="configurationBuilder">The <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder" /> to add to.</param>
         <param name="args">The command line args.</param>
         <summary>
-              Adds a <see cref="T:Microsoft.Extensions.Configuration.CommandLine.CommandLineConfigurationProvider" /> <see cref="T:Microsoft.Extensions.Configuration.IConfigurationProvider" /> 
+              Adds a <see cref="T:Microsoft.Extensions.Configuration.CommandLine.CommandLineConfigurationProvider" />&#160;<see cref="T:Microsoft.Extensions.Configuration.IConfigurationProvider" /> 
               that reads configuration values from the command line.</summary>
         <returns>The <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder" />.</returns>
         <remarks>
@@ -184,7 +184,7 @@ key1=value1
               alias keys (with prefix "--"), mapped to the configuration key (no prefix).
             </param>
         <summary>
-              Adds a <see cref="T:Microsoft.Extensions.Configuration.CommandLine.CommandLineConfigurationProvider" /> <see cref="T:Microsoft.Extensions.Configuration.IConfigurationProvider" /> that reads
+              Adds a <see cref="T:Microsoft.Extensions.Configuration.CommandLine.CommandLineConfigurationProvider" />&#160;<see cref="T:Microsoft.Extensions.Configuration.IConfigurationProvider" /> that reads
               configuration values from the command line using the specified switch mappings.</summary>
         <returns>The <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder" />.</returns>
         <remarks>
diff --git a/xml/Microsoft.Extensions.Options/IOptionsMonitor`1.xml b/xml/Microsoft.Extensions.Options/IOptionsMonitor`1.xml
index 795098a0f80..ae83f95bf03 100644
--- a/xml/Microsoft.Extensions.Options/IOptionsMonitor`1.xml
+++ b/xml/Microsoft.Extensions.Options/IOptionsMonitor`1.xml
@@ -93,7 +93,7 @@
         <Parameter Name="name" Type="System.String" Index="0" FrameworkAlternate="dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;dotnet-plat-ext-3.0;dotnet-plat-ext-3.1;dotnet-plat-ext-5.0;dotnet-plat-ext-6.0;dotnet-plat-ext-7.0" />
       </Parameters>
       <Docs>
-        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if a <see langword="null" /> <see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is used.</param>
+        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if a <see langword="null" />&#160;<see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is used.</param>
         <summary>Returns a configured <typeparamref name="TOptions" /> instance with the given name.</summary>
         <returns>The <typeparamref name="TOptions" /> instance that matches the given <paramref name="name" />.</returns>
         <remarks>To be added.</remarks>
diff --git a/xml/Microsoft.Extensions.Options/IOptionsSnapshot`1.xml b/xml/Microsoft.Extensions.Options/IOptionsSnapshot`1.xml
index b68e31c36e2..9d97d6d7934 100644
--- a/xml/Microsoft.Extensions.Options/IOptionsSnapshot`1.xml
+++ b/xml/Microsoft.Extensions.Options/IOptionsSnapshot`1.xml
@@ -76,7 +76,7 @@
         <Parameter Name="name" Type="System.String" Index="0" FrameworkAlternate="dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;dotnet-plat-ext-3.0;dotnet-plat-ext-3.1;dotnet-plat-ext-5.0;dotnet-plat-ext-6.0;dotnet-plat-ext-7.0" />
       </Parameters>
       <Docs>
-        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if <see langword="null" /> <see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is used.</param>
+        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if <see langword="null" />&#160;<see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is used.</param>
         <summary>Returns a configured <typeparamref name="TOptions" /> instance with the given name.</summary>
         <returns>The <typeparamref name="TOptions" /> instance that matches the given <paramref name="name" />.</returns>
         <remarks>To be added.</remarks>
diff --git a/xml/Microsoft.Extensions.Options/OptionsManager`1.xml b/xml/Microsoft.Extensions.Options/OptionsManager`1.xml
index 6a33958d0f4..9ebab0845c0 100644
--- a/xml/Microsoft.Extensions.Options/OptionsManager`1.xml
+++ b/xml/Microsoft.Extensions.Options/OptionsManager`1.xml
@@ -139,7 +139,7 @@
         <Parameter Name="name" Type="System.String" Index="0" FrameworkAlternate="dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;dotnet-plat-ext-3.0;dotnet-plat-ext-3.1;dotnet-plat-ext-5.0;dotnet-plat-ext-6.0;dotnet-plat-ext-7.0" />
       </Parameters>
       <Docs>
-        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if a <see langword="null" /> <see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is used.</param>
+        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if a <see langword="null" />&#160;<see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is used.</param>
         <summary>Returns a configured <typeparamref name="TOptions" /> instance with the given <paramref name="name" />.</summary>
         <returns>The <typeparamref name="TOptions" /> instance that matches the given <paramref name="name" />.</returns>
         <remarks>To be added.</remarks>
diff --git a/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml b/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml
index 71f59387524..6e11310d7f3 100644
--- a/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml
+++ b/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml
@@ -28,7 +28,7 @@
         <li>
           <see langword="this" /> for <see langword="struct" /> instance methods.</li>
         <li>
-          <see langword="ref" /> parameters that refer to <see langword="ref" /> <see langword="struct" /> types.</li>
+          <see langword="ref" /> parameters that refer to <see langword="ref" />&#160;<see langword="struct" /> types.</li>
         <li>
           <see langword="out" /> parameters.</li>
       </ol>

From 4bbb824ace1c24f19a1886ac1b306c4ed17c532b Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Thu, 17 Nov 2022 12:07:45 -0800
Subject: [PATCH 2/2] Apply suggestions from code review

---
 .../CommandLineConfigurationExtensions.xml                    | 4 ++--
 xml/Microsoft.Extensions.Options/IOptionsMonitor`1.xml        | 2 +-
 xml/Microsoft.Extensions.Options/IOptionsSnapshot`1.xml       | 2 +-
 xml/Microsoft.Extensions.Options/OptionsManager`1.xml         | 2 +-
 xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml  | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/xml/Microsoft.Extensions.Configuration/CommandLineConfigurationExtensions.xml b/xml/Microsoft.Extensions.Configuration/CommandLineConfigurationExtensions.xml
index 7be6d61a7e6..1b625c5cdf5 100644
--- a/xml/Microsoft.Extensions.Configuration/CommandLineConfigurationExtensions.xml
+++ b/xml/Microsoft.Extensions.Configuration/CommandLineConfigurationExtensions.xml
@@ -94,7 +94,7 @@
         <param name="configurationBuilder">The <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder" /> to add to.</param>
         <param name="args">The command line args.</param>
         <summary>
-              Adds a <see cref="T:Microsoft.Extensions.Configuration.CommandLine.CommandLineConfigurationProvider" />&#160;<see cref="T:Microsoft.Extensions.Configuration.IConfigurationProvider" /> 
+              Adds a <see cref="T:Microsoft.Extensions.Configuration.CommandLine.CommandLineConfigurationProvider" /> 
               that reads configuration values from the command line.</summary>
         <returns>The <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder" />.</returns>
         <remarks>
@@ -184,7 +184,7 @@ key1=value1
               alias keys (with prefix "--"), mapped to the configuration key (no prefix).
             </param>
         <summary>
-              Adds a <see cref="T:Microsoft.Extensions.Configuration.CommandLine.CommandLineConfigurationProvider" />&#160;<see cref="T:Microsoft.Extensions.Configuration.IConfigurationProvider" /> that reads
+              Adds a <see cref="T:Microsoft.Extensions.Configuration.CommandLine.CommandLineConfigurationProvider" /> that reads
               configuration values from the command line using the specified switch mappings.</summary>
         <returns>The <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder" />.</returns>
         <remarks>
diff --git a/xml/Microsoft.Extensions.Options/IOptionsMonitor`1.xml b/xml/Microsoft.Extensions.Options/IOptionsMonitor`1.xml
index ae83f95bf03..431569ebecc 100644
--- a/xml/Microsoft.Extensions.Options/IOptionsMonitor`1.xml
+++ b/xml/Microsoft.Extensions.Options/IOptionsMonitor`1.xml
@@ -93,7 +93,7 @@
         <Parameter Name="name" Type="System.String" Index="0" FrameworkAlternate="dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;dotnet-plat-ext-3.0;dotnet-plat-ext-3.1;dotnet-plat-ext-5.0;dotnet-plat-ext-6.0;dotnet-plat-ext-7.0" />
       </Parameters>
       <Docs>
-        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if a <see langword="null" />&#160;<see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is used.</param>
+        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if <see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is <see langword="null" />.</param>
         <summary>Returns a configured <typeparamref name="TOptions" /> instance with the given name.</summary>
         <returns>The <typeparamref name="TOptions" /> instance that matches the given <paramref name="name" />.</returns>
         <remarks>To be added.</remarks>
diff --git a/xml/Microsoft.Extensions.Options/IOptionsSnapshot`1.xml b/xml/Microsoft.Extensions.Options/IOptionsSnapshot`1.xml
index 9d97d6d7934..bc605afcd2c 100644
--- a/xml/Microsoft.Extensions.Options/IOptionsSnapshot`1.xml
+++ b/xml/Microsoft.Extensions.Options/IOptionsSnapshot`1.xml
@@ -76,7 +76,7 @@
         <Parameter Name="name" Type="System.String" Index="0" FrameworkAlternate="dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;dotnet-plat-ext-3.0;dotnet-plat-ext-3.1;dotnet-plat-ext-5.0;dotnet-plat-ext-6.0;dotnet-plat-ext-7.0" />
       </Parameters>
       <Docs>
-        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if <see langword="null" />&#160;<see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is used.</param>
+        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if <see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is <see langword="null" />.</param>
         <summary>Returns a configured <typeparamref name="TOptions" /> instance with the given name.</summary>
         <returns>The <typeparamref name="TOptions" /> instance that matches the given <paramref name="name" />.</returns>
         <remarks>To be added.</remarks>
diff --git a/xml/Microsoft.Extensions.Options/OptionsManager`1.xml b/xml/Microsoft.Extensions.Options/OptionsManager`1.xml
index 9ebab0845c0..ca0cedb0b59 100644
--- a/xml/Microsoft.Extensions.Options/OptionsManager`1.xml
+++ b/xml/Microsoft.Extensions.Options/OptionsManager`1.xml
@@ -139,7 +139,7 @@
         <Parameter Name="name" Type="System.String" Index="0" FrameworkAlternate="dotnet-plat-ext-2.0;dotnet-plat-ext-2.1;dotnet-plat-ext-2.2;dotnet-plat-ext-3.0;dotnet-plat-ext-3.1;dotnet-plat-ext-5.0;dotnet-plat-ext-6.0;dotnet-plat-ext-7.0" />
       </Parameters>
       <Docs>
-        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if a <see langword="null" />&#160;<see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is used.</param>
+        <param name="name">The name of the <typeparamref name="TOptions" /> instance, if <see cref="F:Microsoft.Extensions.Options.Options.DefaultName" /> is <see langword="null" />.</param>
         <summary>Returns a configured <typeparamref name="TOptions" /> instance with the given <paramref name="name" />.</summary>
         <returns>The <typeparamref name="TOptions" /> instance that matches the given <paramref name="name" />.</returns>
         <remarks>To be added.</remarks>
diff --git a/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml b/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml
index 6e11310d7f3..7aa6be6a499 100644
--- a/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml
+++ b/xml/System.Diagnostics.CodeAnalysis/UnscopedRefAttribute.xml
@@ -28,7 +28,7 @@
         <li>
           <see langword="this" /> for <see langword="struct" /> instance methods.</li>
         <li>
-          <see langword="ref" /> parameters that refer to <see langword="ref" />&#160;<see langword="struct" /> types.</li>
+          <see langword="ref" /> parameters that refer to <see langword="ref struct" /> types.</li>
         <li>
           <see langword="out" /> parameters.</li>
       </ol>