Add See Also links for Configuration APIs (dotnet#8768)

MSDN-WhiteKnight · web-flow · commit 665081b686a4 · 2023-01-06T19:55:59.000Z
diff --git a/xml/Microsoft.Extensions.Configuration.CommandLine/CommandLineConfigurationProvider.xml b/xml/Microsoft.Extensions.Configuration.CommandLine/CommandLineConfigurationProvider.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>A command line based <see cref="T:Microsoft.Extensions.Configuration.ConfigurationProvider" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [Command-line configuration provider](/dotnet/core/extensions/configuration-providers#command-line-configuration-provider).
+  
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/Microsoft.Extensions.Configuration.EnvironmentVariables/EnvironmentVariablesConfigurationProvider.xml b/xml/Microsoft.Extensions.Configuration.EnvironmentVariables/EnvironmentVariablesConfigurationProvider.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>An environment variable based <see cref="T:Microsoft.Extensions.Configuration.ConfigurationProvider" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [Environment variable configuration provider](/dotnet/core/extensions/configuration-providers#environment-variable-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/Microsoft.Extensions.Configuration.Ini/IniConfigurationProvider.xml b/xml/Microsoft.Extensions.Configuration.Ini/IniConfigurationProvider.xml
@@ -23,17 +23,27 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>An INI file based <see cref="T:Microsoft.Extensions.Configuration.ConfigurationProvider" />.
-            Files are simple line structures (<see href="https://en.wikipedia.org/wiki/INI_file">INI Files on Wikipedia</see>).</summary>
-    <remarks>To be added.</remarks>
-    <examples>
-            [Section:Header]
-            key1=value1
-            key2 = " value2 "
-            ; comment
-            # comment
-            / comment
-            </examples>
+    <summary>An INI file based <see cref="T:Microsoft.Extensions.Configuration.ConfigurationProvider" />.</summary>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+INI files are simple line structures ([INI Files on Wikipedia](https://en.wikipedia.org/wiki/INI_file)). The following example demonstrates a structure of the INI file:
+
+```
+[Section:Header]
+key1=value1
+key2 = " value2 "
+; comment
+# comment
+/ comment
+```
+
+For more information and examples, see [INI configuration provider](/dotnet/core/extensions/configuration-providers#ini-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/Microsoft.Extensions.Configuration.Json/JsonConfigurationProvider.xml b/xml/Microsoft.Extensions.Configuration.Json/JsonConfigurationProvider.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>A JSON file based <see cref="T:Microsoft.Extensions.Configuration.FileConfigurationProvider" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [JSON configuration provider](/dotnet/core/extensions/configuration-providers#json-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/Microsoft.Extensions.Configuration.Memory/MemoryConfigurationProvider.xml b/xml/Microsoft.Extensions.Configuration.Memory/MemoryConfigurationProvider.xml
@@ -31,7 +31,15 @@
   </Interfaces>
   <Docs>
     <summary>In-memory implementation of <see cref="T:Microsoft.Extensions.Configuration.IConfigurationProvider" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [Memory configuration provider](/dotnet/core/extensions/configuration-providers#memory-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/Microsoft.Extensions.Configuration.Xml/XmlConfigurationProvider.xml b/xml/Microsoft.Extensions.Configuration.Xml/XmlConfigurationProvider.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>Represents an XML file as an <see cref="T:Microsoft.Extensions.Configuration.IConfigurationSource" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [XML configuration provider](/dotnet/core/extensions/configuration-providers#xml-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/Microsoft.Extensions.Configuration/CommandLineConfigurationExtensions.xml b/xml/Microsoft.Extensions.Configuration/CommandLineConfigurationExtensions.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>Extension methods for registering <see cref="T:Microsoft.Extensions.Configuration.CommandLine.CommandLineConfigurationProvider" /> with <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [Command-line configuration provider](/dotnet/core/extensions/configuration-providers#command-line-configuration-provider).
+  
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="AddCommandLine">
diff --git a/xml/Microsoft.Extensions.Configuration/ConfigurationBinder.xml b/xml/Microsoft.Extensions.Configuration/ConfigurationBinder.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>Static helper class that allows binding strongly typed objects to configuration values.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [Binding](/dotnet/core/extensions/configuration#binding).
+  
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="Bind">
diff --git a/xml/Microsoft.Extensions.Configuration/ConfigurationProvider.xml b/xml/Microsoft.Extensions.Configuration/ConfigurationProvider.xml
@@ -28,7 +28,15 @@
   </Interfaces>
   <Docs>
     <summary>Base helper class for implementing an <see cref="T:Microsoft.Extensions.Configuration.IConfigurationProvider" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information, see [Configuration providers in .NET](/dotnet/core/extensions/configuration-providers).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/Microsoft.Extensions.Configuration/EnvironmentVariablesExtensions.xml b/xml/Microsoft.Extensions.Configuration/EnvironmentVariablesExtensions.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>Extension methods for registering <see cref="T:Microsoft.Extensions.Configuration.EnvironmentVariables.EnvironmentVariablesConfigurationProvider" /> with <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [Environment variable configuration provider](/dotnet/core/extensions/configuration-providers#environment-variable-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="AddEnvironmentVariables">
diff --git a/xml/Microsoft.Extensions.Configuration/FileConfigurationExtensions.xml b/xml/Microsoft.Extensions.Configuration/FileConfigurationExtensions.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>Extension methods for <see cref="T:Microsoft.Extensions.Configuration.FileConfigurationProvider" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [File configuration provider](/dotnet/core/extensions/configuration-providers#file-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="GetFileLoadExceptionHandler">
diff --git a/xml/Microsoft.Extensions.Configuration/FileConfigurationProvider.xml b/xml/Microsoft.Extensions.Configuration/FileConfigurationProvider.xml
@@ -33,7 +33,15 @@
   </Interfaces>
   <Docs>
     <summary>Base class for file based <see cref="T:Microsoft.Extensions.Configuration.ConfigurationProvider" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [File configuration provider](/dotnet/core/extensions/configuration-providers#file-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">
diff --git a/xml/Microsoft.Extensions.Configuration/IConfiguration.xml b/xml/Microsoft.Extensions.Configuration/IConfiguration.xml
@@ -21,7 +21,15 @@
   <Interfaces />
   <Docs>
     <summary>Represents a set of key/value application configuration properties.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information, see [Configuration in .NET](/dotnet/core/extensions/configuration).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="GetChildren">
diff --git a/xml/Microsoft.Extensions.Configuration/IniConfigurationExtensions.xml b/xml/Microsoft.Extensions.Configuration/IniConfigurationExtensions.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>Extension methods for adding <see cref="T:Microsoft.Extensions.Configuration.Ini.IniConfigurationProvider" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [INI configuration provider](/dotnet/core/extensions/configuration-providers#ini-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="AddIniFile">
diff --git a/xml/Microsoft.Extensions.Configuration/JsonConfigurationExtensions.xml b/xml/Microsoft.Extensions.Configuration/JsonConfigurationExtensions.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>Extension methods for adding <see cref="T:Microsoft.Extensions.Configuration.Json.JsonConfigurationProvider" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [JSON configuration provider](/dotnet/core/extensions/configuration-providers#json-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="AddJsonFile">
diff --git a/xml/Microsoft.Extensions.Configuration/MemoryConfigurationBuilderExtensions.xml b/xml/Microsoft.Extensions.Configuration/MemoryConfigurationBuilderExtensions.xml
@@ -23,8 +23,16 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>IConfigurationBuilder extension methods for the MemoryConfigurationProvider.</summary>
-    <remarks>To be added.</remarks>
+    <summary>Provides <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder" /> extension methods for the <see cref="T:Microsoft.Extensions.Configuration.Memory.MemoryConfigurationProvider" />.</summary>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [Memory configuration provider](/dotnet/core/extensions/configuration-providers#memory-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="AddInMemoryCollection">
diff --git a/xml/Microsoft.Extensions.Configuration/XmlConfigurationExtensions.xml b/xml/Microsoft.Extensions.Configuration/XmlConfigurationExtensions.xml
@@ -24,7 +24,15 @@
   <Interfaces />
   <Docs>
     <summary>Extension methods for adding <see cref="T:Microsoft.Extensions.Configuration.Xml.XmlConfigurationProvider" />.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For more information and examples, see [XML configuration provider](/dotnet/core/extensions/configuration-providers#xml-configuration-provider).
+
+   ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="AddXmlFile">
