diff --git a/BREAKING-CHANGES.md b/BREAKING-CHANGES.md
new file mode 100644
index 0000000000..3eb6d65009
--- /dev/null
+++ b/BREAKING-CHANGES.md
@@ -0,0 +1,9 @@
+![zf1-future logo](https://imgur.com/S0i6qOh.png)
+<sub><sup>Thanks to [WebTigers](https://github.com/WebTigers) for the logo</sup></sub>
+
+#AIM of this doc.
+As pressure to implement some PHP 8.2+ related changes are raising, we are goig to track any possible breaking change, starting from version 1.24.0
+
+### 1.24.0
+* some depracation messages have been suppresses for 8.1, but reverted: https://github.com/Shardj/zf1-future/issues/377
+
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7467f58c9f..bb3baee09d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.24.0] - 2024-02-05
+- introduced BREAKING CHANGES doc.
+
+### Added
+- support "samesite" cookie attribute in Zend_Http_Header_SetCookie in https://github.com/Shardj/zf1-future/issues/315
+- Support X-Forwarded-Proto header in https://github.com/Shardj/zf1-future/pull/386
+- added setting to disable automatic strigify of pdo mysql in https://github.com/Shardj/zf1-future/pull/378
+
+### Fixed
+- reverted Deprecated : Return type on Zend_Session_SaveHandler_DbTable in https://github.com/Shardj/zf1-future/issues/377
+- Zend_Db_Adapter_Db2 limit does not work in https://github.com/Shardj/zf1-future/issues/391
+- Zend_Http_Client-Adapter_Socket - check transfer-encoding header is a string (and not an array) in https://github.com/Shardj/zf1-future/pull/396
+- Fixes A non-numeric value encountered in PhpMath.php in https://github.com/Shardj/zf1-future/pull/402
+- Updated DocBlocks to return $this for fluent interface in https://github.com/Shardj/zf1-future/pull/390
+- add "array" as allowed type of $value in https://github.com/Shardj/zf1-future/pull/387
+- Avoid undefined array key access inside url assembly in https://github.com/Shardj/zf1-future/pull/383
+- Fixed #357 return type backward-compatible issue reported in https://github.com/Shardj/zf1-future/pull/379
+- Fixed missing property in https://github.com/Shardj/zf1-future/pull/376
+
+
 ## [1.23.5] - 2023-08-24
 ### Fixed
 - further Zend Mail sendmail transport validation tweak
diff --git a/README.md b/README.md
index 77cf049fe2..b8ea93d47d 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,7 @@
 # Zend Framework 1 now for PHP 8.1!
 ### Classic ZF1 Reborn
 Zend may have abandoned the original Zend Framework, but the global Zend Framework Community has not! Since Zend sentenced ZF1 to EOL, the Zend Framework community around the globe has continued to work and build on what we consider to be one of the best PHP frameworks of all time.
+Framework is tested by users up to PHP version 8.1. Note, that with 8.2+ you can experience some incompatibilities.
 
 # ZF1-Future Sponsors
 ### Products and Projects built with ZF1-Future:
diff --git a/composer.json b/composer.json
index eab8bcded7..4ad0de3e0b 100644
--- a/composer.json
+++ b/composer.json
@@ -2,7 +2,7 @@
     "name": "shardj/zf1-future",
     "description": "Zend Framework 1. The aim is to keep ZF1 working with the latest PHP versions",
     "type": "library",
-    "version": "1.23.5",
+    "version": "1.24.0",
     "keywords": [
         "framework",
         "zf1"