From d095bd1b5c83f2662d37d9b69c77150e160717d2 Mon Sep 17 00:00:00 2001
From: Hong Li <hongli@microsoft.com>
Date: Mon, 11 Nov 2024 17:03:39 -0800
Subject: [PATCH 1/6] Adding Reame file for each Nuget package

---
 .../src/Readme.md                              | 17 +++++++++++++++++
 .../src/System.ServiceModel.Federation.csproj  |  1 +
 src/System.ServiceModel.Http/src/Readme.md     | 18 ++++++++++++++++++
 .../src/System.ServiceModel.Http.csproj        |  1 +
 .../src/Readme.md                              | 18 ++++++++++++++++++
 .../System.ServiceModel.NetFramingBase.csproj  |  1 +
 .../src/Readme.md                              | 18 ++++++++++++++++++
 .../System.ServiceModel.NetNamedPipe.csproj    |  2 ++
 src/System.ServiceModel.NetTcp/src/Readme.md   | 18 ++++++++++++++++++
 .../src/System.ServiceModel.NetTcp.csproj      |  1 +
 .../src/Readme.md                              | 18 ++++++++++++++++++
 .../src/System.ServiceModel.Primitives.csproj  |  1 +
 .../src/Readme.md                              | 18 ++++++++++++++++++
 ...System.ServiceModel.UnixDomainSocket.csproj |  1 +
 .../src/Readme.md                              | 18 ++++++++++++++++++
 .../src/System.Web.Services.Description.csproj |  1 +
 16 files changed, 152 insertions(+)
 create mode 100644 src/System.ServiceModel.Federation/src/Readme.md
 create mode 100644 src/System.ServiceModel.Http/src/Readme.md
 create mode 100644 src/System.ServiceModel.NetFramingBase/src/Readme.md
 create mode 100644 src/System.ServiceModel.NetNamedPipe/src/Readme.md
 create mode 100644 src/System.ServiceModel.NetTcp/src/Readme.md
 create mode 100644 src/System.ServiceModel.Primitives/src/Readme.md
 create mode 100644 src/System.ServiceModel.UnixDomainSocket/src/Readme.md
 create mode 100644 src/System.Web.Services.Description/src/Readme.md

diff --git a/src/System.ServiceModel.Federation/src/Readme.md b/src/System.ServiceModel.Federation/src/Readme.md
new file mode 100644
index 00000000000..c025da6d8d6
--- /dev/null
+++ b/src/System.ServiceModel.Federation/src/Readme.md
@@ -0,0 +1,17 @@
+## About
+
+The System.ServiceModel.Federation provides the types that allow security communications with SOAP messages using WS-Federation.
+
+### Installing the package:
+
+Install System.ServiceModel.Federation ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.Federation)
+
+`dotnet add package System.ServiceModel.Federation`
+
+## How to use
+
+See [blog post](https://devblogs.microsoft.com/dotnet/wsfederationhttpbinding-in-net-standard-wcf/) for more information.
+p## Feedback & Contributing
+
+To explore the project or contribute, visit our [GitHub repository](https://github.com/dotnet/wcf/).
+For reporting issues or providing feedback, please [open an issue on GitHub](https://github.com/dotnet/wcf).
\ No newline at end of file
diff --git a/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj b/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj
index d0b70331521..b89cc44d6f6 100644
--- a/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj
+++ b/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj
@@ -12,6 +12,7 @@
     <CentralPackageTransitivePinningEnabled>true</CentralPackageTransitivePinningEnabled>
     <PackageDescription>Provides the types that allow security communications with SOAP messages using WS-Federation.</PackageDescription>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <PackageReadmeFile>Readme.md</PackageReadmeFile>
   </PropertyGroup>
   <ItemGroup>
     <ProjectReference Include="..\..\System.ServiceModel.Primitives\src\System.ServiceModel.Primitives.csproj" />
diff --git a/src/System.ServiceModel.Http/src/Readme.md b/src/System.ServiceModel.Http/src/Readme.md
new file mode 100644
index 00000000000..e839717aa7b
--- /dev/null
+++ b/src/System.ServiceModel.Http/src/Readme.md
@@ -0,0 +1,18 @@
+## About
+
+The System.ServiceModel.Http provides the types that permit SOAP messages to be exchanged using Http (example: BasicHttpBinding).
+
+### Installing the package:
+
+Install System.ServiceModel.Http ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.Http)
+
+`dotnet add package System.ServiceModel.Http`
+
+## How to use
+
+See [WCF Samples](https://learn.microsoft.com/en-us/dotnet/framework/wcf/samples/) for samples on how to use System.ServiceModel.Http.
+
+## Feedback & Contributing
+
+To explore the project or contribute, visit our [GitHub repository](https://github.com/dotnet/wcf/).
+For reporting issues or providing feedback, please [open an issue on GitHub](https://github.com/dotnet/wcf).
\ No newline at end of file
diff --git a/src/System.ServiceModel.Http/src/System.ServiceModel.Http.csproj b/src/System.ServiceModel.Http/src/System.ServiceModel.Http.csproj
index cd891ba9103..6dbb61f9472 100644
--- a/src/System.ServiceModel.Http/src/System.ServiceModel.Http.csproj
+++ b/src/System.ServiceModel.Http/src/System.ServiceModel.Http.csproj
@@ -10,6 +10,7 @@
     <TargetFrameworks>$(DotNetVersion);$(NetFrameworkVersion);netstandard2.0</TargetFrameworks>
     <IsShipping>$(Ship_WcfPackages)</IsShipping>
     <PackageDescription>Provides the types that permit SOAP messages to be exchanged using Http (example: BasicHttpBinding).</PackageDescription>
+    <PackageReadmeFile>Readme.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup Condition="'$(TargetFramework)' != '$(NetFrameworkVersion)'">
diff --git a/src/System.ServiceModel.NetFramingBase/src/Readme.md b/src/System.ServiceModel.NetFramingBase/src/Readme.md
new file mode 100644
index 00000000000..f279d8c9375
--- /dev/null
+++ b/src/System.ServiceModel.NetFramingBase/src/Readme.md
@@ -0,0 +1,18 @@
+## About
+
+The System.ServiceModel.NetFramingBase contains common types for NetFraming based transports such as NetTcp and NetNamedPipe.
+
+### Installing the package:
+
+Install System.ServiceModel.NetFramingBase ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.NetFramingBase)
+
+`dotnet add package System.ServiceModel.NetFramingBase`
+
+## How to use
+
+See [WCF Samples](https://learn.microsoft.com/en-us/dotnet/framework/wcf/samples/) for samples on how to use NetTcp and NetNamedPipe.
+
+## Feedback & Contributing
+
+To explore the project or contribute, visit our [GitHub repository](https://github.com/dotnet/wcf/).
+For reporting issues or providing feedback, please [open an issue on GitHub](https://github.com/dotnet/wcf).
\ No newline at end of file
diff --git a/src/System.ServiceModel.NetFramingBase/src/System.ServiceModel.NetFramingBase.csproj b/src/System.ServiceModel.NetFramingBase/src/System.ServiceModel.NetFramingBase.csproj
index 764b0c01810..6d04180c0bd 100644
--- a/src/System.ServiceModel.NetFramingBase/src/System.ServiceModel.NetFramingBase.csproj
+++ b/src/System.ServiceModel.NetFramingBase/src/System.ServiceModel.NetFramingBase.csproj
@@ -9,6 +9,7 @@
     <TargetFrameworks>$(DotNetVersion)</TargetFrameworks>
     <RootNamespace>System.ServiceModel</RootNamespace>
     <PackageDescription>Contain common types for NetFraming based transports such as NetTcp and NetNamedPipe.</PackageDescription>
+    <PackageReadmeFile>Readme.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup>
diff --git a/src/System.ServiceModel.NetNamedPipe/src/Readme.md b/src/System.ServiceModel.NetNamedPipe/src/Readme.md
new file mode 100644
index 00000000000..7fd13b90eb4
--- /dev/null
+++ b/src/System.ServiceModel.NetNamedPipe/src/Readme.md
@@ -0,0 +1,18 @@
+## About
+
+The System.ServiceModel.NetNamedPipe provides the types that permit SOAP messages to be exchanged using TCP (example: NetTcpBinding).
+
+### Installing the package:
+
+Install System.ServiceModel.NetNamedPipe ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.NetNamedPipe)
+
+`dotnet add package System.ServiceModel.NetNamedPipe`
+
+## How to use
+
+See [WCF Samples](https://learn.microsoft.com/en-us/dotnet/framework/wcf/samples/) for samples on how to use NetNamePipe and NetTcpBinding.
+
+## Feedback & Contributing
+
+To explore the project or contribute, visit our [GitHub repository](https://github.com/dotnet/wcf/).
+For reporting issues or providing feedback, please [open an issue on GitHub](https://github.com/dotnet/wcf).
\ No newline at end of file
diff --git a/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj b/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj
index 360e24673a9..b5fa41c30c9 100644
--- a/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj
+++ b/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj
@@ -10,11 +10,13 @@
     <RootNamespace>System.ServiceModel</RootNamespace>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
     <PackageDescription>Provides the types that permit SOAP messages to be exchanged using named pipes (example: NetNamedPipeBinding).</PackageDescription>
+    <PackageReadmeFile>Readme.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup>
     <ProjectReference Include="..\..\System.ServiceModel.Primitives\src\System.ServiceModel.Primitives.csproj" />
     <ProjectReference Include="..\..\System.ServiceModel.NetFramingBase\src\System.ServiceModel.NetFramingBase.csproj" />
+    <None Include="Readme.md" Pack="true" PackagePath="\"/>
   </ItemGroup>
 
   <!--The default source produced by the Arcade SDK does not work with the checked-in source file SR.cs (class/namespace/filename)-->
diff --git a/src/System.ServiceModel.NetTcp/src/Readme.md b/src/System.ServiceModel.NetTcp/src/Readme.md
new file mode 100644
index 00000000000..7392ad4c124
--- /dev/null
+++ b/src/System.ServiceModel.NetTcp/src/Readme.md
@@ -0,0 +1,18 @@
+## About
+
+The System.ServiceModel.NetTcp provides the types that permit SOAP messages to be exchanged using TCP (example: NetTcpBinding).
+
+### Installing the package:
+
+Install System.ServiceModel.NetTcp ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.NetTcp)
+
+`dotnet add package System.ServiceModel.NetTcp`
+
+## How to use
+
+See [WCF Samples](https://learn.microsoft.com/en-us/dotnet/framework/wcf/samples/) for samples on how to use NetTcp.
+
+## Feedback & Contributing
+
+To explore the project or contribute, visit our [GitHub repository](https://github.com/dotnet/wcf/).
+For reporting issues or providing feedback, please [open an issue on GitHub](https://github.com/dotnet/wcf).
\ No newline at end of file
diff --git a/src/System.ServiceModel.NetTcp/src/System.ServiceModel.NetTcp.csproj b/src/System.ServiceModel.NetTcp/src/System.ServiceModel.NetTcp.csproj
index ff6f78fa162..467a20e35a5 100644
--- a/src/System.ServiceModel.NetTcp/src/System.ServiceModel.NetTcp.csproj
+++ b/src/System.ServiceModel.NetTcp/src/System.ServiceModel.NetTcp.csproj
@@ -10,6 +10,7 @@
     <TargetFrameworks>$(DotNetVersion);$(NetFrameworkVersion);netstandard2.0</TargetFrameworks>
     <IsShipping>$(Ship_WcfPackages)</IsShipping>
     <PackageDescription>Provides the types that permit SOAP messages to be exchanged using TCP (example: NetTcpBinding).</PackageDescription>
+    <PackageReadmeFile>Readme.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup Condition="'$(TargetFramework)' != '$(NetFrameworkVersion)'">
diff --git a/src/System.ServiceModel.Primitives/src/Readme.md b/src/System.ServiceModel.Primitives/src/Readme.md
new file mode 100644
index 00000000000..b531ae4f123
--- /dev/null
+++ b/src/System.ServiceModel.Primitives/src/Readme.md
@@ -0,0 +1,18 @@
+## About
+
+The System.ServiceModel.Primitives provides the common types used by all of the WCF libraries.
+
+### Installing the package:
+
+Install System.ServiceModel.Primitives ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.Primitives)
+
+`dotnet add package System.ServiceModel.Primitives`
+
+## How to use
+
+Explore [WCF Samples](https://learn.microsoft.com/en-us/dotnet/framework/wcf/samples/) for more WCF samples.
+
+## Feedback & Contributing
+
+To explore the project or contribute, visit our [GitHub repository](https://github.com/dotnet/wcf/).
+For reporting issues or providing feedback, please [open an issue on GitHub](https://github.com/dotnet/wcf).
\ No newline at end of file
diff --git a/src/System.ServiceModel.Primitives/src/System.ServiceModel.Primitives.csproj b/src/System.ServiceModel.Primitives/src/System.ServiceModel.Primitives.csproj
index ccd0f4f6f88..ee512a101a1 100644
--- a/src/System.ServiceModel.Primitives/src/System.ServiceModel.Primitives.csproj
+++ b/src/System.ServiceModel.Primitives/src/System.ServiceModel.Primitives.csproj
@@ -18,6 +18,7 @@
          we wouldn't compile it anyway. -->
     <GenAPIGenerateReferenceAssemblySource>false</GenAPIGenerateReferenceAssemblySource>
     <IncludeSRCommonCode>false</IncludeSRCommonCode>
+    <PackageReadmeFile>Readme.md</PackageReadmeFile>
   </PropertyGroup>
   <ItemGroup Condition="'$(TargetFramework)' == '$(DotNetVersion)'">
     <InternalsVisibleTo Include="System.ServiceModel.Http" />
diff --git a/src/System.ServiceModel.UnixDomainSocket/src/Readme.md b/src/System.ServiceModel.UnixDomainSocket/src/Readme.md
new file mode 100644
index 00000000000..8e1da89bc56
--- /dev/null
+++ b/src/System.ServiceModel.UnixDomainSocket/src/Readme.md
@@ -0,0 +1,18 @@
+## About
+
+The System.ServiceModel.UnixDomainSocket Provides the types that allow security communications with SOAP messages using WS-Federation.
+
+### Installing the package:
+
+Install System.ServiceModel.UnixDomainSocket ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.UnixDomainSocket)
+
+`dotnet add package System.ServiceModel.UnixDomainSocket`
+
+## How to use
+
+See [blog post](https://corewcf.github.io/blog/2023/09/01/udsbinding) for more information.
+
+## Feedback & Contributing
+
+To explore the project or contribute, visit our [GitHub repository](https://github.com/dotnet/wcf/).
+For reporting issues or providing feedback, please [open an issue on GitHub](https://github.com/dotnet/wcf).
\ No newline at end of file
diff --git a/src/System.ServiceModel.UnixDomainSocket/src/System.ServiceModel.UnixDomainSocket.csproj b/src/System.ServiceModel.UnixDomainSocket/src/System.ServiceModel.UnixDomainSocket.csproj
index 687995bd308..a589b71f200 100644
--- a/src/System.ServiceModel.UnixDomainSocket/src/System.ServiceModel.UnixDomainSocket.csproj
+++ b/src/System.ServiceModel.UnixDomainSocket/src/System.ServiceModel.UnixDomainSocket.csproj
@@ -8,6 +8,7 @@
     <TargetFrameworks>$(DotNetVersion)</TargetFrameworks>
     <IsShipping>$(Ship_WcfPackages)</IsShipping>
     <PackageDescription>Provides the types that permit SOAP messages to be exchanged using Unix domain socket.</PackageDescription>
+    <PackageReadmeFile>Readme.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup>
diff --git a/src/System.Web.Services.Description/src/Readme.md b/src/System.Web.Services.Description/src/Readme.md
new file mode 100644
index 00000000000..1ee7dc4fe5c
--- /dev/null
+++ b/src/System.Web.Services.Description/src/Readme.md
@@ -0,0 +1,18 @@
+## About
+
+The System.Web.Services.Description contains classes that enable you to publicly describe an XML Web service by using the Web Services Description Language (WSDL).
+
+### Installing the package:
+
+Install System.Web.Services.Description package from [Nuget.org](https://www.nuget.org/packages/System.Web.Services.Description)
+
+`dotnet add package System.Web.Services.Description`
+
+## How to use
+
+Explore [WCF Samples](https://learn.microsoft.com/en-us/dotnet/framework/wcf/samples/) for more WCF samples.
+
+## Feedback & Contributing
+
+To explore the project or contribute, visit our [GitHub repository](https://github.com/dotnet/wcf/).
+For reporting issues or providing feedback, please [open an issue on GitHub](https://github.com/dotnet/wcf).
\ No newline at end of file
diff --git a/src/System.Web.Services.Description/src/System.Web.Services.Description.csproj b/src/System.Web.Services.Description/src/System.Web.Services.Description.csproj
index cab5c3f4d60..5ab4890e078 100644
--- a/src/System.Web.Services.Description/src/System.Web.Services.Description.csproj
+++ b/src/System.Web.Services.Description/src/System.Web.Services.Description.csproj
@@ -11,6 +11,7 @@
     <IsPartialFacadeAssembly Condition="'$(TargetFramework)' == '$(NetFrameworkVersion)'">true</IsPartialFacadeAssembly>
     <EnableDefaultItems Condition="'$(TargetFramework)' == '$(NetFrameworkVersion)'">false</EnableDefaultItems>
     <PackageDescription>Contains classes that enable you to publicly describe an XML Web service by using the Web Services Description Language (WSDL).</PackageDescription>
+    <PackageReadmeFile>Readme.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup Condition="'$(TargetFramework)' == '$(NetFrameworkVersion)'">

From a71c7c007ad0bb37e0959b44399c17c25ba56cc9 Mon Sep 17 00:00:00 2001
From: Hong Li <hongli@microsoft.com>
Date: Mon, 11 Nov 2024 17:08:34 -0800
Subject: [PATCH 2/6] more minor fixes

---
 src/System.ServiceModel.Federation/src/Readme.md               | 3 ++-
 .../src/System.ServiceModel.NetNamedPipe.csproj                | 1 -
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/System.ServiceModel.Federation/src/Readme.md b/src/System.ServiceModel.Federation/src/Readme.md
index c025da6d8d6..3c247a74589 100644
--- a/src/System.ServiceModel.Federation/src/Readme.md
+++ b/src/System.ServiceModel.Federation/src/Readme.md
@@ -11,7 +11,8 @@ Install System.ServiceModel.Federation ackage from [Nuget.org](https://www.nuget
 ## How to use
 
 See [blog post](https://devblogs.microsoft.com/dotnet/wsfederationhttpbinding-in-net-standard-wcf/) for more information.
-p## Feedback & Contributing
+
+## Feedback & Contributing
 
 To explore the project or contribute, visit our [GitHub repository](https://github.com/dotnet/wcf/).
 For reporting issues or providing feedback, please [open an issue on GitHub](https://github.com/dotnet/wcf).
\ No newline at end of file
diff --git a/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj b/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj
index b5fa41c30c9..229b737735d 100644
--- a/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj
+++ b/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj
@@ -16,7 +16,6 @@
   <ItemGroup>
     <ProjectReference Include="..\..\System.ServiceModel.Primitives\src\System.ServiceModel.Primitives.csproj" />
     <ProjectReference Include="..\..\System.ServiceModel.NetFramingBase\src\System.ServiceModel.NetFramingBase.csproj" />
-    <None Include="Readme.md" Pack="true" PackagePath="\"/>
   </ItemGroup>
 
   <!--The default source produced by the Arcade SDK does not work with the checked-in source file SR.cs (class/namespace/filename)-->

From 153ab3c08d6d93a8725c91115d47544798a5e2ca Mon Sep 17 00:00:00 2001
From: Hong Li <hongli@microsoft.com>
Date: Mon, 11 Nov 2024 20:22:03 -0800
Subject: [PATCH 3/6] rename to README.md, and delete package description

---
 .../src/{Readme.md => README.md}                              | 0
 .../src/System.ServiceModel.Federation.csproj                 | 4 ++--
 src/System.ServiceModel.Http/src/{Readme.md => README.md}     | 0
 .../src/System.ServiceModel.Http.csproj                       | 3 +--
 .../src/{Readme.md => README.md}                              | 0
 .../src/System.ServiceModel.NetFramingBase.csproj             | 3 +--
 .../src/{Readme.md => README.md}                              | 0
 .../src/System.ServiceModel.NetNamedPipe.csproj               | 3 +--
 src/System.ServiceModel.NetTcp/src/{Readme.md => README.md}   | 0
 .../src/System.ServiceModel.NetTcp.csproj                     | 3 +--
 .../src/{Readme.md => README.md}                              | 0
 .../src/System.ServiceModel.Primitives.csproj                 | 3 +--
 .../src/{Readme.md => README.md}                              | 0
 .../src/{Readme.md => README.md}                              | 0
 .../src/System.Web.Services.Description.csproj                | 3 +--
 15 files changed, 8 insertions(+), 14 deletions(-)
 rename src/System.ServiceModel.Federation/src/{Readme.md => README.md} (100%)
 rename src/System.ServiceModel.Http/src/{Readme.md => README.md} (100%)
 rename src/System.ServiceModel.NetFramingBase/src/{Readme.md => README.md} (100%)
 rename src/System.ServiceModel.NetNamedPipe/src/{Readme.md => README.md} (100%)
 rename src/System.ServiceModel.NetTcp/src/{Readme.md => README.md} (100%)
 rename src/System.ServiceModel.Primitives/src/{Readme.md => README.md} (100%)
 rename src/System.ServiceModel.UnixDomainSocket/src/{Readme.md => README.md} (100%)
 rename src/System.Web.Services.Description/src/{Readme.md => README.md} (100%)

diff --git a/src/System.ServiceModel.Federation/src/Readme.md b/src/System.ServiceModel.Federation/src/README.md
similarity index 100%
rename from src/System.ServiceModel.Federation/src/Readme.md
rename to src/System.ServiceModel.Federation/src/README.md
diff --git a/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj b/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj
index b89cc44d6f6..ac2fd5a41e2 100644
--- a/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj
+++ b/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj
@@ -10,13 +10,13 @@
     <!-- Enable transitive pinning due to Microsoft.IdentityModel.Protocols.WsTrust not being
          proactively updated by the identity team and it now references vulnerable dependencies -->
     <CentralPackageTransitivePinningEnabled>true</CentralPackageTransitivePinningEnabled>
-    <PackageDescription>Provides the types that allow security communications with SOAP messages using WS-Federation.</PackageDescription>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
-    <PackageReadmeFile>Readme.md</PackageReadmeFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
   <ItemGroup>
     <ProjectReference Include="..\..\System.ServiceModel.Primitives\src\System.ServiceModel.Primitives.csproj" />
     <ProjectReference Include="..\..\System.ServiceModel.Http\src\System.ServiceModel.Http.csproj" />
+
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="Microsoft.IdentityModel.Protocols.WsTrust" Version="$(MicrosoftIdentityModelProtocolsWsTrustPackageVersion)" />
diff --git a/src/System.ServiceModel.Http/src/Readme.md b/src/System.ServiceModel.Http/src/README.md
similarity index 100%
rename from src/System.ServiceModel.Http/src/Readme.md
rename to src/System.ServiceModel.Http/src/README.md
diff --git a/src/System.ServiceModel.Http/src/System.ServiceModel.Http.csproj b/src/System.ServiceModel.Http/src/System.ServiceModel.Http.csproj
index 6dbb61f9472..f6192e28e1c 100644
--- a/src/System.ServiceModel.Http/src/System.ServiceModel.Http.csproj
+++ b/src/System.ServiceModel.Http/src/System.ServiceModel.Http.csproj
@@ -9,8 +9,7 @@
     <NoWarn>$(NoWarn);NU5131</NoWarn>
     <TargetFrameworks>$(DotNetVersion);$(NetFrameworkVersion);netstandard2.0</TargetFrameworks>
     <IsShipping>$(Ship_WcfPackages)</IsShipping>
-    <PackageDescription>Provides the types that permit SOAP messages to be exchanged using Http (example: BasicHttpBinding).</PackageDescription>
-    <PackageReadmeFile>Readme.md</PackageReadmeFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup Condition="'$(TargetFramework)' != '$(NetFrameworkVersion)'">
diff --git a/src/System.ServiceModel.NetFramingBase/src/Readme.md b/src/System.ServiceModel.NetFramingBase/src/README.md
similarity index 100%
rename from src/System.ServiceModel.NetFramingBase/src/Readme.md
rename to src/System.ServiceModel.NetFramingBase/src/README.md
diff --git a/src/System.ServiceModel.NetFramingBase/src/System.ServiceModel.NetFramingBase.csproj b/src/System.ServiceModel.NetFramingBase/src/System.ServiceModel.NetFramingBase.csproj
index 6d04180c0bd..cf203c2d71a 100644
--- a/src/System.ServiceModel.NetFramingBase/src/System.ServiceModel.NetFramingBase.csproj
+++ b/src/System.ServiceModel.NetFramingBase/src/System.ServiceModel.NetFramingBase.csproj
@@ -8,8 +8,7 @@
     <IsShipping>$(Ship_WcfPackages)</IsShipping>
     <TargetFrameworks>$(DotNetVersion)</TargetFrameworks>
     <RootNamespace>System.ServiceModel</RootNamespace>
-    <PackageDescription>Contain common types for NetFraming based transports such as NetTcp and NetNamedPipe.</PackageDescription>
-    <PackageReadmeFile>Readme.md</PackageReadmeFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup>
diff --git a/src/System.ServiceModel.NetNamedPipe/src/Readme.md b/src/System.ServiceModel.NetNamedPipe/src/README.md
similarity index 100%
rename from src/System.ServiceModel.NetNamedPipe/src/Readme.md
rename to src/System.ServiceModel.NetNamedPipe/src/README.md
diff --git a/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj b/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj
index 229b737735d..2769378ef28 100644
--- a/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj
+++ b/src/System.ServiceModel.NetNamedPipe/src/System.ServiceModel.NetNamedPipe.csproj
@@ -9,8 +9,7 @@
     <TargetFrameworks>$(DotNetVersion)</TargetFrameworks>
     <RootNamespace>System.ServiceModel</RootNamespace>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
-    <PackageDescription>Provides the types that permit SOAP messages to be exchanged using named pipes (example: NetNamedPipeBinding).</PackageDescription>
-    <PackageReadmeFile>Readme.md</PackageReadmeFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup>
diff --git a/src/System.ServiceModel.NetTcp/src/Readme.md b/src/System.ServiceModel.NetTcp/src/README.md
similarity index 100%
rename from src/System.ServiceModel.NetTcp/src/Readme.md
rename to src/System.ServiceModel.NetTcp/src/README.md
diff --git a/src/System.ServiceModel.NetTcp/src/System.ServiceModel.NetTcp.csproj b/src/System.ServiceModel.NetTcp/src/System.ServiceModel.NetTcp.csproj
index 467a20e35a5..4a31ca472d4 100644
--- a/src/System.ServiceModel.NetTcp/src/System.ServiceModel.NetTcp.csproj
+++ b/src/System.ServiceModel.NetTcp/src/System.ServiceModel.NetTcp.csproj
@@ -9,8 +9,7 @@
     <NoWarn>$(NoWarn);NU5131</NoWarn>
     <TargetFrameworks>$(DotNetVersion);$(NetFrameworkVersion);netstandard2.0</TargetFrameworks>
     <IsShipping>$(Ship_WcfPackages)</IsShipping>
-    <PackageDescription>Provides the types that permit SOAP messages to be exchanged using TCP (example: NetTcpBinding).</PackageDescription>
-    <PackageReadmeFile>Readme.md</PackageReadmeFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup Condition="'$(TargetFramework)' != '$(NetFrameworkVersion)'">
diff --git a/src/System.ServiceModel.Primitives/src/Readme.md b/src/System.ServiceModel.Primitives/src/README.md
similarity index 100%
rename from src/System.ServiceModel.Primitives/src/Readme.md
rename to src/System.ServiceModel.Primitives/src/README.md
diff --git a/src/System.ServiceModel.Primitives/src/System.ServiceModel.Primitives.csproj b/src/System.ServiceModel.Primitives/src/System.ServiceModel.Primitives.csproj
index ee512a101a1..634571f4937 100644
--- a/src/System.ServiceModel.Primitives/src/System.ServiceModel.Primitives.csproj
+++ b/src/System.ServiceModel.Primitives/src/System.ServiceModel.Primitives.csproj
@@ -11,14 +11,13 @@
     <TargetFrameworks>$(DotNetVersion);$(NetFrameworkVersion);netstandard2.0</TargetFrameworks>
     <LangVersion>latest</LangVersion>
     <IsShipping>$(Ship_WcfPackages)</IsShipping>
-    <PackageDescription>Provides the common types used by all of the WCF libraries.</PackageDescription>
     <!-- The implementation assembly for Primitives doesn't yet match the reference assembly
          Generating the reference assembly would generate api's we don't want. For now the
          Primitives.Ref project has disabled EnableDefaultCompileItems so if it was generated,
          we wouldn't compile it anyway. -->
     <GenAPIGenerateReferenceAssemblySource>false</GenAPIGenerateReferenceAssemblySource>
     <IncludeSRCommonCode>false</IncludeSRCommonCode>
-    <PackageReadmeFile>Readme.md</PackageReadmeFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
   <ItemGroup Condition="'$(TargetFramework)' == '$(DotNetVersion)'">
     <InternalsVisibleTo Include="System.ServiceModel.Http" />
diff --git a/src/System.ServiceModel.UnixDomainSocket/src/Readme.md b/src/System.ServiceModel.UnixDomainSocket/src/README.md
similarity index 100%
rename from src/System.ServiceModel.UnixDomainSocket/src/Readme.md
rename to src/System.ServiceModel.UnixDomainSocket/src/README.md
diff --git a/src/System.Web.Services.Description/src/Readme.md b/src/System.Web.Services.Description/src/README.md
similarity index 100%
rename from src/System.Web.Services.Description/src/Readme.md
rename to src/System.Web.Services.Description/src/README.md
diff --git a/src/System.Web.Services.Description/src/System.Web.Services.Description.csproj b/src/System.Web.Services.Description/src/System.Web.Services.Description.csproj
index 5ab4890e078..3843fd15b55 100644
--- a/src/System.Web.Services.Description/src/System.Web.Services.Description.csproj
+++ b/src/System.Web.Services.Description/src/System.Web.Services.Description.csproj
@@ -10,8 +10,7 @@
     <TargetFrameworks>netstandard2.0;$(NetFrameworkVersion)</TargetFrameworks>
     <IsPartialFacadeAssembly Condition="'$(TargetFramework)' == '$(NetFrameworkVersion)'">true</IsPartialFacadeAssembly>
     <EnableDefaultItems Condition="'$(TargetFramework)' == '$(NetFrameworkVersion)'">false</EnableDefaultItems>
-    <PackageDescription>Contains classes that enable you to publicly describe an XML Web service by using the Web Services Description Language (WSDL).</PackageDescription>
-    <PackageReadmeFile>Readme.md</PackageReadmeFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup Condition="'$(TargetFramework)' == '$(NetFrameworkVersion)'">

From 0622459959942898c1eb7e14db9c02ee6ab9b404 Mon Sep 17 00:00:00 2001
From: Hong Li <hongli@microsoft.com>
Date: Mon, 11 Nov 2024 20:57:03 -0800
Subject: [PATCH 4/6] add a central step in Directory.Build.targets to pickup
 README.md

---
 Directory.Build.targets                                       | 4 ++++
 .../src/System.ServiceModel.Federation.csproj                 | 1 -
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/Directory.Build.targets b/Directory.Build.targets
index aa0cce7b6c2..f5de7802b4e 100644
--- a/Directory.Build.targets
+++ b/Directory.Build.targets
@@ -57,6 +57,10 @@
       <_Parameter1>true</_Parameter1>
     </AssemblyAttribute>
   </ItemGroup>
+
+  <ItemGroup Condition="Exists('README.md')" >
+    <None Include="README.md" Pack="true" PackagePath="\"/>
+  </ItemGroup>
   
   <Import Project="eng\RuntimePackages.targets" Condition="'$(StrongNameKeyId)' == 'Microsoft'" />
 </Project>
diff --git a/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj b/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj
index ac2fd5a41e2..ca23b0b5590 100644
--- a/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj
+++ b/src/System.ServiceModel.Federation/src/System.ServiceModel.Federation.csproj
@@ -16,7 +16,6 @@
   <ItemGroup>
     <ProjectReference Include="..\..\System.ServiceModel.Primitives\src\System.ServiceModel.Primitives.csproj" />
     <ProjectReference Include="..\..\System.ServiceModel.Http\src\System.ServiceModel.Http.csproj" />
-
   </ItemGroup>
   <ItemGroup>
     <PackageReference Include="Microsoft.IdentityModel.Protocols.WsTrust" Version="$(MicrosoftIdentityModelProtocolsWsTrustPackageVersion)" />

From ab84202c88c91d2678f504c7583813e67e4464bf Mon Sep 17 00:00:00 2001
From: Matt Connew <mconnew@users.noreply.github.com>
Date: Mon, 11 Nov 2024 21:41:20 -0800
Subject: [PATCH 5/6] Fix typo in readme files

---
 src/System.ServiceModel.Federation/src/README.md       | 2 +-
 src/System.ServiceModel.Http/src/README.md             | 2 +-
 src/System.ServiceModel.NetFramingBase/src/README.md   | 2 +-
 src/System.ServiceModel.NetNamedPipe/src/README.md     | 2 +-
 src/System.ServiceModel.NetTcp/src/README.md           | 2 +-
 src/System.ServiceModel.Primitives/src/README.md       | 2 +-
 src/System.ServiceModel.UnixDomainSocket/src/README.md | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/System.ServiceModel.Federation/src/README.md b/src/System.ServiceModel.Federation/src/README.md
index 3c247a74589..4a73b63fe0c 100644
--- a/src/System.ServiceModel.Federation/src/README.md
+++ b/src/System.ServiceModel.Federation/src/README.md
@@ -4,7 +4,7 @@ The System.ServiceModel.Federation provides the types that allow security commun
 
 ### Installing the package:
 
-Install System.ServiceModel.Federation ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.Federation)
+Install System.ServiceModel.Federation package from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.Federation)
 
 `dotnet add package System.ServiceModel.Federation`
 
diff --git a/src/System.ServiceModel.Http/src/README.md b/src/System.ServiceModel.Http/src/README.md
index e839717aa7b..3f90ddd7341 100644
--- a/src/System.ServiceModel.Http/src/README.md
+++ b/src/System.ServiceModel.Http/src/README.md
@@ -4,7 +4,7 @@ The System.ServiceModel.Http provides the types that permit SOAP messages to be
 
 ### Installing the package:
 
-Install System.ServiceModel.Http ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.Http)
+Install System.ServiceModel.Http package from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.Http)
 
 `dotnet add package System.ServiceModel.Http`
 
diff --git a/src/System.ServiceModel.NetFramingBase/src/README.md b/src/System.ServiceModel.NetFramingBase/src/README.md
index f279d8c9375..7e57dbc7edc 100644
--- a/src/System.ServiceModel.NetFramingBase/src/README.md
+++ b/src/System.ServiceModel.NetFramingBase/src/README.md
@@ -4,7 +4,7 @@ The System.ServiceModel.NetFramingBase contains common types for NetFraming base
 
 ### Installing the package:
 
-Install System.ServiceModel.NetFramingBase ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.NetFramingBase)
+Install System.ServiceModel.NetFramingBase package from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.NetFramingBase)
 
 `dotnet add package System.ServiceModel.NetFramingBase`
 
diff --git a/src/System.ServiceModel.NetNamedPipe/src/README.md b/src/System.ServiceModel.NetNamedPipe/src/README.md
index 7fd13b90eb4..56d0685a895 100644
--- a/src/System.ServiceModel.NetNamedPipe/src/README.md
+++ b/src/System.ServiceModel.NetNamedPipe/src/README.md
@@ -4,7 +4,7 @@ The System.ServiceModel.NetNamedPipe provides the types that permit SOAP message
 
 ### Installing the package:
 
-Install System.ServiceModel.NetNamedPipe ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.NetNamedPipe)
+Install System.ServiceModel.NetNamedPipe package from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.NetNamedPipe)
 
 `dotnet add package System.ServiceModel.NetNamedPipe`
 
diff --git a/src/System.ServiceModel.NetTcp/src/README.md b/src/System.ServiceModel.NetTcp/src/README.md
index 7392ad4c124..4b09edd7ec0 100644
--- a/src/System.ServiceModel.NetTcp/src/README.md
+++ b/src/System.ServiceModel.NetTcp/src/README.md
@@ -4,7 +4,7 @@ The System.ServiceModel.NetTcp provides the types that permit SOAP messages to b
 
 ### Installing the package:
 
-Install System.ServiceModel.NetTcp ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.NetTcp)
+Install System.ServiceModel.NetTcp package from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.NetTcp)
 
 `dotnet add package System.ServiceModel.NetTcp`
 
diff --git a/src/System.ServiceModel.Primitives/src/README.md b/src/System.ServiceModel.Primitives/src/README.md
index b531ae4f123..ad73adf158e 100644
--- a/src/System.ServiceModel.Primitives/src/README.md
+++ b/src/System.ServiceModel.Primitives/src/README.md
@@ -4,7 +4,7 @@ The System.ServiceModel.Primitives provides the common types used by all of the
 
 ### Installing the package:
 
-Install System.ServiceModel.Primitives ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.Primitives)
+Install System.ServiceModel.Primitives package from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.Primitives)
 
 `dotnet add package System.ServiceModel.Primitives`
 
diff --git a/src/System.ServiceModel.UnixDomainSocket/src/README.md b/src/System.ServiceModel.UnixDomainSocket/src/README.md
index 8e1da89bc56..931e3169b55 100644
--- a/src/System.ServiceModel.UnixDomainSocket/src/README.md
+++ b/src/System.ServiceModel.UnixDomainSocket/src/README.md
@@ -4,7 +4,7 @@ The System.ServiceModel.UnixDomainSocket Provides the types that allow security
 
 ### Installing the package:
 
-Install System.ServiceModel.UnixDomainSocket ackage from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.UnixDomainSocket)
+Install System.ServiceModel.UnixDomainSocket package from [Nuget.org](https://www.nuget.org/packages/System.ServiceModel.UnixDomainSocket)
 
 `dotnet add package System.ServiceModel.UnixDomainSocket`
 

From 49f2680679e35731f7026a52bec3a2c89601e9a0 Mon Sep 17 00:00:00 2001
From: Matt Connew <mconnew@users.noreply.github.com>
Date: Mon, 11 Nov 2024 21:50:12 -0800
Subject: [PATCH 6/6] Update
 src/System.ServiceModel.UnixDomainSocket/src/System.ServiceModel.UnixDomainSocket.csproj

---
 .../src/System.ServiceModel.UnixDomainSocket.csproj             | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/System.ServiceModel.UnixDomainSocket/src/System.ServiceModel.UnixDomainSocket.csproj b/src/System.ServiceModel.UnixDomainSocket/src/System.ServiceModel.UnixDomainSocket.csproj
index a589b71f200..7f6f13dabeb 100644
--- a/src/System.ServiceModel.UnixDomainSocket/src/System.ServiceModel.UnixDomainSocket.csproj
+++ b/src/System.ServiceModel.UnixDomainSocket/src/System.ServiceModel.UnixDomainSocket.csproj
@@ -8,7 +8,7 @@
     <TargetFrameworks>$(DotNetVersion)</TargetFrameworks>
     <IsShipping>$(Ship_WcfPackages)</IsShipping>
     <PackageDescription>Provides the types that permit SOAP messages to be exchanged using Unix domain socket.</PackageDescription>
-    <PackageReadmeFile>Readme.md</PackageReadmeFile>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup>