diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1443494..ae5bbeb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # Changelog
 
+## 3.1.0 (2023-11-16)
+
+*   Feature: Full PHP 8.3 compatibility.
+    (#255 by @clue)
+
+*   Feature: Describe all callable arguments with types for `Promise` and `Deferred`.
+    (#253 by @clue)
+
+*   Update test suite and minor documentation improvements.
+    (#251 by @ondrejmirtes and #250 by @SQKo)
+
 ## 3.0.0 (2023-07-11)
 
 A major new feature release, see [**release announcement**](https://clue.engineering/2023/announcing-reactphp-promise-v3).
diff --git a/README.md b/README.md
index 38ab622..5cb6f7d 100644
--- a/README.md
+++ b/README.md
@@ -664,7 +664,7 @@ This project follows [SemVer](https://semver.org/).
 This will install the latest supported version from this branch:
 
 ```bash
-composer require react/promise:^3
+composer require react/promise:^3.1
 ```
 
 See also the [CHANGELOG](CHANGELOG.md) for details about version upgrades.