diff --git a/src/cloudscribe.Pagination.Models/README.md b/src/cloudscribe.Pagination.Models/README.md
new file mode 100644
index 0000000..d8a74d5
--- /dev/null
+++ b/src/cloudscribe.Pagination.Models/README.md
@@ -0,0 +1,17 @@
+# cloudscribe.Pagination.Models
+
+Shared models used by cloudscribe pagination libraries.
+
+## Usage
+
+This is an internal/shared library and is typically referenced by other cloudscribe projects. If you need to use the models directly:
+
+1. Install the NuGet package:
+   ```shell
+   dotnet add package cloudscribe.Pagination.Models
+   ```
+2. Reference the models in your code as needed.
+
+## License
+
+Licensed under the Apache-2.0 License.
diff --git a/src/cloudscribe.Pagination.Models/cloudscribe.Pagination.Models.csproj b/src/cloudscribe.Pagination.Models/cloudscribe.Pagination.Models.csproj
index ad15982..2dbb907 100644
--- a/src/cloudscribe.Pagination.Models/cloudscribe.Pagination.Models.csproj
+++ b/src/cloudscribe.Pagination.Models/cloudscribe.Pagination.Models.csproj
@@ -3,7 +3,7 @@
   <PropertyGroup>
     <Description>Pagination models</Description>
     <Copyright>Source Tree Solutions</Copyright>
-    <Version>8.3.0</Version>
+    <Version>8.4.0</Version>
     <Authors>Joe Audette</Authors>
     
     <TargetFramework>net8.0</TargetFramework>
@@ -15,8 +15,13 @@
     <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
     <RepositoryUrl>https://github.com/cloudscribe/cloudscribe.Web.Pagination.git</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="" />
+  </ItemGroup>
+
   <ItemGroup>
     <PackageReference Include="System.Linq.Queryable" Version="4.3.0" />
   </ItemGroup>
diff --git a/src/cloudscribe.Web.Pagination/README.md b/src/cloudscribe.Web.Pagination/README.md
new file mode 100644
index 0000000..d16bd20
--- /dev/null
+++ b/src/cloudscribe.Web.Pagination/README.md
@@ -0,0 +1,24 @@
+# cloudscribe.Web.Pagination
+
+An ASP.NET Core TagHelper for pagination. Provides flexible, customizable, and Bootstrap-compatible pagination controls for web applications.
+
+## Usage
+
+1. Install the NuGet package:
+   ```shell
+   dotnet add package cloudscribe.Web.Pagination
+   ```
+2. Add the TagHelper to your `_ViewImports.cshtml`:
+   ```csharp
+   @addTagHelper *, cloudscribe.Web.Pagination
+   ```
+3. Use the `<cs-pager>` TagHelper in your Razor views:
+   ```html
+   <cs-pager ... />
+   ```
+
+For full documentation and advanced usage, see the [GitHub repo](https://github.com/joeaudette/cloudscribe.Web.Pagination).
+
+## License
+
+Licensed under the Apache-2.0 License.
diff --git a/src/cloudscribe.Web.Pagination/cloudscribe.Web.Pagination.csproj b/src/cloudscribe.Web.Pagination/cloudscribe.Web.Pagination.csproj
index 03ca28b..c2a6ad3 100644
--- a/src/cloudscribe.Web.Pagination/cloudscribe.Web.Pagination.csproj
+++ b/src/cloudscribe.Web.Pagination/cloudscribe.Web.Pagination.csproj
@@ -3,7 +3,7 @@
   <PropertyGroup>
     <Description>an AspNetCore TagHelper for pagination</Description>
     <Copyright>Source Tree Solutions</Copyright>
-    <Version>8.3.0</Version>
+    <Version>8.4.0</Version>
     <TargetFramework>net8.0</TargetFramework>
     <Authors>Joe Audette</Authors>
     <PackageTags>cloudscribe;mvc;pagination;navigation;bootstrap</PackageTags>
@@ -14,8 +14,13 @@
     <RepositoryUrl>https://github.com/cloudscribe/cloudscribe.Web.Pagination.git</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
     
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="" />
+  </ItemGroup>
+
   <ItemGroup>
     <FrameworkReference Include="Microsoft.AspNetCore.App" />
   </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