diff --git a/src/libraries/Microsoft.Extensions.Configuration.Ini/README.md b/src/libraries/Microsoft.Extensions.Configuration.Ini/README.md
new file mode 100644
index 00000000000000..0e7ca833b61e34
--- /dev/null
+++ b/src/libraries/Microsoft.Extensions.Configuration.Ini/README.md
@@ -0,0 +1,57 @@
+# Microsoft.Extensions.Configuration.Ini
+
+INI configuration provider implementation for [Microsoft.Extensions.Configuration](https://www.nuget.org/packages/Microsoft.Extensions.Configuration/). This package enables you to read configuration parameters from [INI files](https://en.wikipedia.org/wiki/INI_file). You can use [IniConfigurationExtensions.AddIniFile](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iniconfigurationextensions.addinifile) extension method on `IConfigurationBuilder` to add INI configuration provider to the configuration builder.
+
+Documentation can be found at https://learn.microsoft.com/dotnet/core/extensions/configuration-providers#ini-configuration-provider
+
+## Contribution Bar
+- [x] [We consider new features, new APIs, bug fixes, and performance changes](https://github.com/dotnet/runtime/tree/main/src/libraries#contribution-bar)
+
+The APIs and functionality are mature, but do get extended occasionally.
+
+## Deployment
+[Microsoft.Extensions.Configuration.Ini](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.Ini/) is included in the ASP.NET Core shared framework. The package is deployed as out-of-band (OOB) too and can be referenced into projects directly.
+
+## Example
+The following example shows how to read the application configuration from INI file.
+
+```cs
+using System;
+using Microsoft.Extensions.Configuration;
+
+class Program
+{
+ static void Main()
+ {
+ // Build a configuration object from INI file
+ IConfiguration config = new ConfigurationBuilder()
+ .AddIniFile("appsettings.ini")
+ .Build();
+
+ // Get a configuration section
+ IConfigurationSection section = config.GetSection("Settings");
+
+ // Read configuration values
+ Console.WriteLine($"Server: {section["Server"]}");
+ Console.WriteLine($"Database: {section["Database"]}");
+ }
+}
+```
+
+To run this example, include an `appsettings.ini` file with the following content in your project:
+
+```
+[Settings]
+Server=example.com
+Database=Northwind
+```
+
+You can include a configuration file using a code like this in your `.csproj` file:
+
+```xml
+
+
+ Always
+
+
+```
diff --git a/src/libraries/Microsoft.Extensions.Configuration.Ini/src/Microsoft.Extensions.Configuration.Ini.csproj b/src/libraries/Microsoft.Extensions.Configuration.Ini/src/Microsoft.Extensions.Configuration.Ini.csproj
index c2a4beba8fa495..3c2ec3c74517d6 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.Ini/src/Microsoft.Extensions.Configuration.Ini.csproj
+++ b/src/libraries/Microsoft.Extensions.Configuration.Ini/src/Microsoft.Extensions.Configuration.Ini.csproj
@@ -5,7 +5,8 @@
true
true
true
- INI configuration provider implementation for Microsoft.Extensions.Configuration.
+ INI configuration provider implementation for Microsoft.Extensions.Configuration. This package enables you to read configuration parameters from INI files. You can use IniConfigurationExtensions.AddIniFile extension method on IConfigurationBuilder to add INI configuration provider to the configuration builder.
+ README.md
@@ -15,6 +16,7 @@
+
diff --git a/src/libraries/Microsoft.Extensions.Configuration.Json/src/README.md b/src/libraries/Microsoft.Extensions.Configuration.Json/README.md
similarity index 73%
rename from src/libraries/Microsoft.Extensions.Configuration.Json/src/README.md
rename to src/libraries/Microsoft.Extensions.Configuration.Json/README.md
index 869626b27e8c26..82a2069a2ec566 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.Json/src/README.md
+++ b/src/libraries/Microsoft.Extensions.Configuration.Json/README.md
@@ -1,14 +1,18 @@
-## About
+# Microsoft.Extensions.Configuration.Json
JSON configuration provider implementation for [Microsoft.Extensions.Configuration](https://www.nuget.org/packages/Microsoft.Extensions.Configuration/). This package enables you to read your application's settings from a JSON file. You can use [JsonConfigurationExtensions.AddJsonFile](https://docs.microsoft.com/dotnet/api/microsoft.extensions.configuration.jsonconfigurationextensions.addjsonfile) extension method on `IConfigurationBuilder` to add the JSON configuration provider to the configuration builder.
-For more information, see the documentation:
+Documentation can be found at https://learn.microsoft.com/dotnet/core/extensions/configuration-providers#json-configuration-provider
-- [Configuration in .NET](https://docs.microsoft.com/dotnet/core/extensions/configuration)
-- [Microsoft.Extensions.Configuration.Json namespace](https://docs.microsoft.com/dotnet/api/microsoft.extensions.configuration.json)
+## Contribution Bar
+- [x] [We consider new features, new APIs, bug fixes, and performance changes](https://github.com/dotnet/runtime/tree/main/src/libraries#contribution-bar)
-## Example
+The APIs and functionality are mature, but do get extended occasionally.
+
+## Deployment
+[Microsoft.Extensions.Configuration.Json](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.Json/) is included in the ASP.NET Core shared framework. The package is deployed as out-of-band (OOB) too and can be referenced into projects directly.
+## Example
The following example shows how to read application settings from the JSON configuration file.
```cs
diff --git a/src/libraries/Microsoft.Extensions.Configuration.Json/src/Microsoft.Extensions.Configuration.Json.csproj b/src/libraries/Microsoft.Extensions.Configuration.Json/src/Microsoft.Extensions.Configuration.Json.csproj
index 121cb04bd5d6ef..5b54af689687d0 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.Json/src/Microsoft.Extensions.Configuration.Json.csproj
+++ b/src/libraries/Microsoft.Extensions.Configuration.Json/src/Microsoft.Extensions.Configuration.Json.csproj
@@ -18,7 +18,7 @@
-
+
diff --git a/src/libraries/Microsoft.Extensions.Configuration.UserSecrets/README.md b/src/libraries/Microsoft.Extensions.Configuration.UserSecrets/README.md
new file mode 100644
index 00000000000000..cb40305e004741
--- /dev/null
+++ b/src/libraries/Microsoft.Extensions.Configuration.UserSecrets/README.md
@@ -0,0 +1,13 @@
+# Microsoft.Extensions.Configuration.UserSecrets
+
+User secrets configuration provider implementation for [Microsoft.Extensions.Configuration](https://www.nuget.org/packages/Microsoft.Extensions.Configuration/). User secrets mechanism enables you to override application configuration settings with values stored in the local secrets file. You can use [UserSecretsConfigurationExtensions.AddUserSecrets](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.usersecretsconfigurationextensions.addusersecrets) extension method on `IConfigurationBuilder` to add user secrets provider to the configuration builder.
+
+Documentation can be found at https://learn.microsoft.com/aspnet/core/security/app-secrets
+
+## Contribution Bar
+- [x] [We consider new features, new APIs, bug fixes, and performance changes](https://github.com/dotnet/runtime/tree/main/src/libraries#contribution-bar)
+
+The APIs and functionality are mature, but do get extended occasionally.
+
+## Deployment
+[Microsoft.Extensions.Configuration.UserSecrets](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.UserSecrets/) is included in the ASP.NET Core shared framework. The package is deployed as out-of-band (OOB) too and can be referenced into projects directly.
diff --git a/src/libraries/Microsoft.Extensions.Configuration.UserSecrets/src/Microsoft.Extensions.Configuration.UserSecrets.csproj b/src/libraries/Microsoft.Extensions.Configuration.UserSecrets/src/Microsoft.Extensions.Configuration.UserSecrets.csproj
index 145f88c0bf50fb..8ac7d50be4d44d 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.UserSecrets/src/Microsoft.Extensions.Configuration.UserSecrets.csproj
+++ b/src/libraries/Microsoft.Extensions.Configuration.UserSecrets/src/Microsoft.Extensions.Configuration.UserSecrets.csproj
@@ -5,7 +5,8 @@
true
true
true
- User secrets configuration provider implementation for Microsoft.Extensions.Configuration.
+ User secrets configuration provider implementation for Microsoft.Extensions.Configuration. User secrets mechanism enables you to override application configuration settings with values stored in the local secrets file. You can use UserSecretsConfigurationExtensions.AddUserSecrets extension method on IConfigurationBuilder to add user secrets provider to the configuration builder.
+ README.md
@@ -15,6 +16,7 @@
+
diff --git a/src/libraries/Microsoft.Extensions.Configuration.Xml/README.md b/src/libraries/Microsoft.Extensions.Configuration.Xml/README.md
new file mode 100644
index 00000000000000..d95c384cbc57f2
--- /dev/null
+++ b/src/libraries/Microsoft.Extensions.Configuration.Xml/README.md
@@ -0,0 +1,69 @@
+# Microsoft.Extensions.Configuration.Xml
+
+XML configuration provider implementation for [Microsoft.Extensions.Configuration](https://www.nuget.org/packages/Microsoft.Extensions.Configuration/). This package enables you to read configuration parameters from XML files. You can use [XmlConfigurationExtensions.AddXmlFile](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.xmlconfigurationextensions.addxmlfile) extension method on `IConfigurationBuilder` to add XML configuration provider to the configuration builder.
+
+Documentation can be found at https://learn.microsoft.com/dotnet/core/extensions/configuration-providers#xml-configuration-provider
+
+## Contribution Bar
+- [x] [We consider new features, new APIs, bug fixes, and performance changes](https://github.com/dotnet/runtime/tree/main/src/libraries#contribution-bar)
+
+The APIs and functionality are mature, but do get extended occasionally.
+
+## Deployment
+[Microsoft.Extensions.Configuration.Xml](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.Xml/) is included in the ASP.NET Core shared framework. The package is deployed as out-of-band (OOB) too and can be referenced into projects directly.
+
+## Example
+The following example shows how to read the application configuration from XML file.
+
+```cs
+using System;
+using Microsoft.Extensions.Configuration;
+
+class Program
+{
+ static void Main()
+ {
+ // Build a configuration object from XML file
+ IConfiguration config = new ConfigurationBuilder()
+ .AddXmlFile("appsettings.xml")
+ .Build();
+
+ // Get a configuration section
+ IConfigurationSection section = config.GetSection("Settings");
+
+ // Read simple values
+ Console.WriteLine($"Server: {section["Server"]}");
+ Console.WriteLine($"Database: {section["Database"]}");
+
+ // Read nested values
+ Console.WriteLine($"IPAddress: {section["Endpoint:IPAddress"]}");
+ Console.WriteLine($"Port: {section["Endpoint:Port"]}");
+ }
+}
+```
+
+To run this example, include an `appsettings.xml` file with the following content in your project:
+
+```xml
+
+
+
+ example.com
+ Northwind
+
+ 192.168.0.10
+ 80
+
+
+
+```
+
+You can include a configuration file using a code like this in your `.csproj` file:
+
+```xml
+
+
+ Always
+
+
+```
diff --git a/src/libraries/Microsoft.Extensions.Configuration.Xml/src/Microsoft.Extensions.Configuration.Xml.csproj b/src/libraries/Microsoft.Extensions.Configuration.Xml/src/Microsoft.Extensions.Configuration.Xml.csproj
index 0cda0b6eedb3ee..f8b1566608202a 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.Xml/src/Microsoft.Extensions.Configuration.Xml.csproj
+++ b/src/libraries/Microsoft.Extensions.Configuration.Xml/src/Microsoft.Extensions.Configuration.Xml.csproj
@@ -5,7 +5,8 @@
true
true
true
- XML configuration provider implementation for Microsoft.Extensions.Configuration.
+ XML configuration provider implementation for Microsoft.Extensions.Configuration. This package enables you to read configuration parameters from XML files. You can use XmlConfigurationExtensions.AddXmlFile extension method on IConfigurationBuilder to add XML configuration provider to the configuration builder.
+ README.md
@@ -16,6 +17,7 @@
+