diff --git a/CHANGELOG.md b/CHANGELOG.md
index 942c9fd5f..3ac8e4790 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,20 @@ All notable changes to **bUnit** will be documented in this file. The project ad
 
 ## [Unreleased]
 
+This major release focuses on platform updates and API simplifications.
+
+For a migration guide, see [Upgrading bUnit](https://bunit.dev/docs/migrations/index.html).
+
+### Changed
+
+- Target framework support updated: added support for .NET 10 (`net10.0`) and dropped all versions prior to .NET 8 (`net8.0`).
+- Cleanup of the API with simplifications of many API calls and methods. This also includes renaming of some objects to better reflect their purpose.
+
+### Added
+
+- Improved renderer logic that catches more edge cases.
+- Improved developer experience in relation to JSInterop.
+
 ## [1.40.0] - 2025-06-14
 
 ### Fixed
diff --git a/README.md b/README.md
index e141b15ed..6e09d14c6 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,14 @@ bUnit is available on NuGet in various incarnations. Most should just pick the [
 
 To get started, head to the [getting started documentation](https://bunit.dev/docs/getting-started) to learn more.
 
+## bUnit and .NET version compatibility matrix
+| bUnit version | .NET version                    |
+| ------------- | ------------------------------- |
+| 1.x           | ≥ .netcore3.1 && ≤ .net 9 |
+| 2.x           | ≥ .net8                      |
+
+For a migration guide, see [Upgrading bUnit](https://bunit.dev/docs/migrations/index.html).
+
 ## Sponsors
 
 A huge thank you to the [sponsors of bUnit](https://github.com/sponsors/egil). The higher tier sponsors are: