diff --git a/src/cloudscribe.Syndication.Web/README.md b/src/cloudscribe.Syndication.Web/README.md
new file mode 100644
index 0000000..3c8a296
--- /dev/null
+++ b/src/cloudscribe.Syndication.Web/README.md
@@ -0,0 +1,17 @@
+# cloudscribe.Syndication.Web
+
+An ASP.NET Core MVC controller for exposing RSS feeds using cloudscribe.Syndication.
+
+## Usage
+
+1. Install the NuGet package:
+   ```shell
+   dotnet add package cloudscribe.Syndication.Web
+   ```
+2. Reference this library in your ASP.NET Core project and configure routes/controllers as needed.
+
+For more details, see the [GitHub repo](https://github.com/cloudscribe/cloudscribe.Syndication).
+
+## License
+
+Licensed under the Apache-2.0 License.
diff --git a/src/cloudscribe.Syndication.Web/cloudscribe.Syndication.Web.csproj b/src/cloudscribe.Syndication.Web/cloudscribe.Syndication.Web.csproj
index 7a2313b..7bca513 100644
--- a/src/cloudscribe.Syndication.Web/cloudscribe.Syndication.Web.csproj
+++ b/src/cloudscribe.Syndication.Web/cloudscribe.Syndication.Web.csproj
@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <Description>asp.netcore mvc controller for rss feeds</Description>
-    <Version>8.3.0</Version>
+    <Version>8.4.0</Version>
     <TargetFramework>net8.0</TargetFramework>
     <Authors>Joe Audette</Authors>
     <PackageTags>cloudscribe;syndication;rss;atom;feed</PackageTags>
@@ -11,8 +11,13 @@
     <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
     <RepositoryUrl>https://github.com/cloudscribe/cloudscribe.Syndication.git</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="" />
+  </ItemGroup>
+
   <ItemGroup>
     <None Include="icon.png" Pack="true" PackagePath="\" />
   </ItemGroup>
diff --git a/src/cloudscribe.Syndication/README.md b/src/cloudscribe.Syndication/README.md
new file mode 100644
index 0000000..45d0501
--- /dev/null
+++ b/src/cloudscribe.Syndication/README.md
@@ -0,0 +1,17 @@
+# cloudscribe.Syndication
+
+A .NET library for RSS and Atom feed generation and consumption.
+
+## Usage
+
+1. Install the NuGet package:
+   ```shell
+   dotnet add package cloudscribe.Syndication
+   ```
+2. Reference the library in your project and use the provided APIs to work with RSS/Atom feeds.
+
+For more details, see the [GitHub repo](https://github.com/cloudscribe/cloudscribe.Syndication).
+
+## License
+
+Licensed under the Apache-2.0 License.
diff --git a/src/cloudscribe.Syndication/cloudscribe.Syndication.csproj b/src/cloudscribe.Syndication/cloudscribe.Syndication.csproj
index e9f2158..0c34ca8 100644
--- a/src/cloudscribe.Syndication/cloudscribe.Syndication.csproj
+++ b/src/cloudscribe.Syndication/cloudscribe.Syndication.csproj
@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <Description>cloudscribe.Syndication Class Library</Description>
-    <Version>8.3.0</Version>
+    <Version>8.4.0</Version>
     <TargetFramework>net8.0</TargetFramework>
     <Authors>Joe Audette</Authors>
     <PackageTags>cloudscribe;syndication;rss;atom;feed;xml</PackageTags>
@@ -12,8 +12,13 @@
     <RepositoryUrl>https://github.com/cloudscribe/cloudscribe.Syndication.git</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
     
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="" />
+  </ItemGroup>
+
   <ItemGroup>
     <None Include="icon.png" Pack="true" PackagePath="\" />
   </ItemGroup>
diff --git a/update_version.ps1 b/update_version.ps1
index 32134c7..0ed4dd0 100644
--- a/update_version.ps1
+++ b/update_version.ps1
@@ -16,9 +16,9 @@
 $directory = "src"
 
 # Define the old & new versions
-$oldVersion = '8\.2'   # slash needed !
-$newVersion = "8.3.0"
-$newWildcardVersion = "8.3.*"
+$oldVersion = '8\.3'   # slash needed !
+$newVersion = "8.4.0"
+$newWildcardVersion = "8.4.*"
 	
 
 # Get all .csproj files in the directory and subdirectories