diff --git a/src/libraries/Microsoft.Extensions.Configuration.Abstractions/README.md b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/README.md
new file mode 100644
index 00000000000000..a6106979b23f2d
--- /dev/null
+++ b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/README.md
@@ -0,0 +1,21 @@
+# Microsoft.Extensions.Configuration.Abstractions
+
+Provides abstractions of key-value pair based configuration. Interfaces defined in this package are implemented by classes in [Microsoft.Extensions.Configuration](https://www.nuget.org/packages/Microsoft.Extensions.Configuration/) and other configuration packages.
+
+Commonly used types:
+
+- [Microsoft.Extensions.Configuration.IConfiguration](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfiguration)
+- [Microsoft.Extensions.Configuration.IConfigurationBuilder](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfigurationbuilder)
+- [Microsoft.Extensions.Configuration.IConfigurationProvider](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfigurationprovider)
+- [Microsoft.Extensions.Configuration.IConfigurationRoot](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfigurationroot)
+- [Microsoft.Extensions.Configuration.IConfigurationSection](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfigurationsection)
+
+Documentation can be found at https://learn.microsoft.com/dotnet/core/extensions/configuration
+
+## 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.Abstractions](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.Abstractions/) 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.Abstractions/src/Microsoft.Extensions.Configuration.Abstractions.csproj b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/Microsoft.Extensions.Configuration.Abstractions.csproj
index 0f89142c400739..29229ba84d43d5 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/Microsoft.Extensions.Configuration.Abstractions.csproj
+++ b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/Microsoft.Extensions.Configuration.Abstractions.csproj
@@ -5,20 +5,15 @@
true
true
true
- Abstractions of key-value pair based configuration.
-
-Commonly Used Types:
-Microsoft.Extensions.Configuration.IConfiguration
-Microsoft.Extensions.Configuration.IConfigurationBuilder
-Microsoft.Extensions.Configuration.IConfigurationProvider
-Microsoft.Extensions.Configuration.IConfigurationRoot
-Microsoft.Extensions.Configuration.IConfigurationSection
+ Provides abstractions of key-value pair based configuration. Interfaces defined in this package are implemented by classes in Microsoft.Extensions.Configuration and other configuration packages.
+ README.md
+
diff --git a/src/libraries/Microsoft.Extensions.Configuration.Binder/README.md b/src/libraries/Microsoft.Extensions.Configuration.Binder/README.md
index 3bd8e9baab932f..3ef7a29905e23e 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.Binder/README.md
+++ b/src/libraries/Microsoft.Extensions.Configuration.Binder/README.md
@@ -5,7 +5,7 @@ Provides the functionality to bind an object to data in configuration providers
Documentation can be found at https://learn.microsoft.com/dotnet/core/extensions/configuration
## Contribution Bar
-- [x] [We consider new features, new APIs, bug fixes, and performance changes](../../libraries/README.md#primary-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.
diff --git a/src/libraries/Microsoft.Extensions.Configuration.CommandLine/README.md b/src/libraries/Microsoft.Extensions.Configuration.CommandLine/README.md
new file mode 100644
index 00000000000000..e2303a425959a1
--- /dev/null
+++ b/src/libraries/Microsoft.Extensions.Configuration.CommandLine/README.md
@@ -0,0 +1,37 @@
+# Microsoft.Extensions.Configuration.CommandLine
+
+Command line configuration provider implementation for [Microsoft.Extensions.Configuration](https://www.nuget.org/packages/Microsoft.Extensions.Configuration/). This package enables you to read configuration parameters from the command line arguments of your application. You can use [CommandLineConfigurationExtensions.AddCommandLine](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.commandlineconfigurationextensions.addcommandline) extension method on `IConfigurationBuilder` to add the command line configuration provider to the configuration builder.
+
+Documentation can be found at https://learn.microsoft.com/dotnet/core/extensions/configuration-providers#command-line-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.CommandLine](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.CommandLine/) 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 configuration from the command line. You can use a command like `dotnet run --InputPath "c:\fizz" --OutputPath "c:\buzz"` to run it.
+
+```cs
+using System;
+using Microsoft.Extensions.Configuration;
+
+class Program
+{
+ static void Main(string[] args)
+ {
+ // Build a configuration object from command line
+ IConfiguration config = new ConfigurationBuilder()
+ .AddCommandLine(args)
+ .Build();
+
+ // Read configuration values
+ Console.WriteLine($"InputPath: {config["InputPath"]}");
+ Console.WriteLine($"OutputPath: {config["OutputPath"]}");
+ }
+}
+```
diff --git a/src/libraries/Microsoft.Extensions.Configuration.CommandLine/src/Microsoft.Extensions.Configuration.CommandLine.csproj b/src/libraries/Microsoft.Extensions.Configuration.CommandLine/src/Microsoft.Extensions.Configuration.CommandLine.csproj
index e7821f8217db96..e12eaf7b294424 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.CommandLine/src/Microsoft.Extensions.Configuration.CommandLine.csproj
+++ b/src/libraries/Microsoft.Extensions.Configuration.CommandLine/src/Microsoft.Extensions.Configuration.CommandLine.csproj
@@ -5,7 +5,8 @@
true
true
true
- Command line configuration provider implementation for Microsoft.Extensions.Configuration.
+ Command line configuration provider implementation for Microsoft.Extensions.Configuration. This package enables you to read configuration parameters from the command line arguments of your application. You can use CommandLineConfigurationExtensions.AddCommandLine extension method on IConfigurationBuilder to add the command line configuration provider to the configuration builder.
+ README.md
@@ -13,6 +14,7 @@
+
diff --git a/src/libraries/Microsoft.Extensions.Configuration.EnvironmentVariables/README.md b/src/libraries/Microsoft.Extensions.Configuration.EnvironmentVariables/README.md
new file mode 100644
index 00000000000000..5763e859c105c5
--- /dev/null
+++ b/src/libraries/Microsoft.Extensions.Configuration.EnvironmentVariables/README.md
@@ -0,0 +1,36 @@
+# Microsoft.Extensions.Configuration.EnvironmentVariables
+
+Environment variables configuration provider implementation for [Microsoft.Extensions.Configuration](https://www.nuget.org/packages/Microsoft.Extensions.Configuration/). This package enables you to read configuration parameters from environment variables. You can use [EnvironmentVariablesExtensions.AddEnvironmentVariables](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.environmentvariablesextensions.addenvironmentvariables) extension method on `IConfigurationBuilder` to add the environment variables configuration provider to the configuration builder.
+
+Documentation can be found at https://learn.microsoft.com/dotnet/core/extensions/configuration-providers#environment-variable-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.EnvironmentVariables](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.EnvironmentVariables/) 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 configuration from environment variables.
+
+```cs
+using System;
+using Microsoft.Extensions.Configuration;
+
+class Program
+{
+ static void Main()
+ {
+ // Build a configuration object from environment variables
+ IConfiguration config = new ConfigurationBuilder()
+ .AddEnvironmentVariables()
+ .Build();
+
+ // Read configuration values
+ Console.WriteLine($"Server: {config["Server"]}");
+ Console.WriteLine($"Database: {config["Database"]}");
+ }
+}
+```
diff --git a/src/libraries/Microsoft.Extensions.Configuration.EnvironmentVariables/src/Microsoft.Extensions.Configuration.EnvironmentVariables.csproj b/src/libraries/Microsoft.Extensions.Configuration.EnvironmentVariables/src/Microsoft.Extensions.Configuration.EnvironmentVariables.csproj
index 8415a9a65bd283..3685b1702ed44d 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.EnvironmentVariables/src/Microsoft.Extensions.Configuration.EnvironmentVariables.csproj
+++ b/src/libraries/Microsoft.Extensions.Configuration.EnvironmentVariables/src/Microsoft.Extensions.Configuration.EnvironmentVariables.csproj
@@ -5,12 +5,14 @@
true
true
true
- Environment variables configuration provider implementation for Microsoft.Extensions.Configuration.
+ Environment variables configuration provider implementation for Microsoft.Extensions.Configuration. This package enables you to read configuration parameters from environment variables. You can use EnvironmentVariablesExtensions.AddEnvironmentVariables extension method on IConfigurationBuilder to add the environment variables configuration provider to the configuration builder.
+ README.md
+
diff --git a/src/libraries/Microsoft.Extensions.Configuration.FileExtensions/README.md b/src/libraries/Microsoft.Extensions.Configuration.FileExtensions/README.md
new file mode 100644
index 00000000000000..868264950becd8
--- /dev/null
+++ b/src/libraries/Microsoft.Extensions.Configuration.FileExtensions/README.md
@@ -0,0 +1,18 @@
+# Microsoft.Extensions.Configuration.FileExtensions
+
+Provides a base class for file-based configuration providers used with [Microsoft.Extensions.Configuration](https://www.nuget.org/packages/Microsoft.Extensions.Configuration/) and extension methods for configuring them.
+
+Commonly used types:
+
+- [Microsoft.Extensions.Configuration.FileConfigurationProvider](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.fileconfigurationprovider)
+- [Microsoft.Extensions.Configuration.FileConfigurationExtensions](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.fileconfigurationextensions)
+
+Documentation can be found at https://learn.microsoft.com/dotnet/core/extensions/configuration
+
+## 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.FileExtensions](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.FileExtensions/) 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.FileExtensions/src/Microsoft.Extensions.Configuration.FileExtensions.csproj b/src/libraries/Microsoft.Extensions.Configuration.FileExtensions/src/Microsoft.Extensions.Configuration.FileExtensions.csproj
index 42815662498204..19dbdaa357104a 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.FileExtensions/src/Microsoft.Extensions.Configuration.FileExtensions.csproj
+++ b/src/libraries/Microsoft.Extensions.Configuration.FileExtensions/src/Microsoft.Extensions.Configuration.FileExtensions.csproj
@@ -5,7 +5,8 @@
true
true
true
- Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration.
+ Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
+ README.md
@@ -16,6 +17,7 @@
+
diff --git a/src/libraries/Microsoft.Extensions.Configuration/README.md b/src/libraries/Microsoft.Extensions.Configuration/README.md
index 503f16fa52638f..63b5c311134a1c 100644
--- a/src/libraries/Microsoft.Extensions.Configuration/README.md
+++ b/src/libraries/Microsoft.Extensions.Configuration/README.md
@@ -5,9 +5,9 @@
Documentation can be found at https://learn.microsoft.com/en-us/dotnet/core/extensions/configuration.
## Contribution Bar
-- [x] [We consider new features, new APIs, bug fixes, and performance changes](../../libraries/README.md#primary-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](https://www.nuget.org/packages/Microsoft.Extensions.Configuration) is not included in the shared framework. The package is deployed as out-of-band (OOB) and needs to be installed into projects directly.
\ No newline at end of file
+[Microsoft.Extensions.Configuration](https://www.nuget.org/packages/Microsoft.Extensions.Configuration) 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/src/Microsoft.Extensions.Configuration.csproj b/src/libraries/Microsoft.Extensions.Configuration/src/Microsoft.Extensions.Configuration.csproj
index 9bb16878523a67..c66c17531a87e7 100644
--- a/src/libraries/Microsoft.Extensions.Configuration/src/Microsoft.Extensions.Configuration.csproj
+++ b/src/libraries/Microsoft.Extensions.Configuration/src/Microsoft.Extensions.Configuration.csproj
@@ -6,6 +6,7 @@
true
true
Implementation of key-value pair based configuration for Microsoft.Extensions.Configuration. Includes the memory configuration provider.
+ README.md
@@ -17,6 +18,7 @@
Link="Common\src\Extensions\EmptyDisposable.cs" />
+