diff --git a/CHANGELOG.md b/CHANGELOG.md
index c81aa08..de421df 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [5.0.0](https://github.com/GetStream/stream-net/compare/4.8.0...5.0.0) (2022-02-28)
+
+
+### Features
+
+- In v5.0.0, [we have refactored the library](https://github.com/GetStream/stream-net/pull/67) to be more maintainable in the future.
+Most importantly, we got rid of some complex internal logic (such as tricky json serialization and deserialization, code organization improvements etc.).
+Also, we made the library more modern such as adding `Async` postfix to async methods. All public
+methods have documentation now and a link to the official docs now. This README file's code snippets are updated to reflect the new changes.
+
+### 🚨 Breaking changes:
+- All async methods have `Async` postfix.
+- Model classes have been moved into `Stream.Models` namespace.
+- All client classes have interfaces now, and `Ref()` methods are not static anymore. This will make it easier to the consumers of this library to unit test them.
+
 ## [4.8.0](https://github.com/GetStream/stream-net/compare/4.7.0...4.8.0) (2022-02-23)
 
 
diff --git a/README.md b/README.md
index 3f76736..e0a0324 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@
 </p>
 
 > ## 🚨 Breaking changes in v5.0 <
-> In v1.0.0, [we have refactored the library](https://github.com/GetStream/stream-net/pull/67) to be more maintainable in the future.
+> In v5.0.0, [we have refactored the library](https://github.com/GetStream/stream-net/pull/67) to be more maintainable in the future.
 > Most importantly, we got rid of some complex internal logic (such as tricky json serialization and deserialization, code organization improvements etc.).
 > Also, we made the library more modern such as adding `Async` postfix to async methods. All public
 > methods have documentation now and a link to the official docs now. This README file's code snippets are updated to reflect the new changes.
diff --git a/src/stream-net.csproj b/src/stream-net.csproj
index f2ff693..61ff87c 100644
--- a/src/stream-net.csproj
+++ b/src/stream-net.csproj
@@ -8,7 +8,7 @@
   <PropertyGroup>
     <PackageId>stream-net</PackageId>
     <Title>.NET Client for Stream Feeds</Title>
-    <Version>4.8.0</Version>
+    <Version>5.0.0</Version>
     <Company>Stream.io</Company>
     <Authors>GetStream.io</Authors>
     <Copyright>© $([System.DateTime]::UtcNow.ToString(yyyy)) Stream.io</Copyright>