diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3592f71751..75492746e0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,25 @@
+# 8.11.0
+
+## API
+
+**Experimental APIs**
+
+* `EsqlQuery`            [documentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/esql-query-api.html)
+* `InferenceDeleteModel` [documentation](https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-inference-api.html)
+* `InferenceGetModel`    [documentation](https://www.elastic.co/guide/en/elasticsearch/reference/master/get-inference-api.html)
+* `InferenceInference`   [documentation](https://www.elastic.co/guide/en/elasticsearch/reference/master/post-inference-api.html)
+* `InferencePutModel`    [documentation](https://www.elastic.co/guide/en/elasticsearch/reference/master/put-inference-api.html)
+
+## Typed API
+
+* Mandatory URL parameters are not exposed as functions anymore as they already exist in the constructor.
+
+# New Compatibility Policy
+
+Starting from version `8.12.0`, this library follow the Go language [policy](https://go.dev/doc/devel/release#policy). Each major Go release is supported until there are two newer major releases. For example, Go 1.5 was supported until the Go 1.7 release, and Go 1.6 was supported until the Go 1.8 release.
+
+If you have any questions or concerns, please do not hesitate to reach out to us.
+
 # 8.10.1
 
 ## Typed API
diff --git a/README.md b/README.md
index 51ef3d2809..f8b674e703 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,13 @@ The official Go client for [Elasticsearch](https://www.elastic.co/products/elast
 [![Integration](https://github.com/elastic/go-elasticsearch/workflows/Integration/badge.svg)](https://github.com/elastic/go-elasticsearch/actions?query=branch%3Amain)
 [![API](https://github.com/elastic/go-elasticsearch/workflows/API/badge.svg)](https://github.com/elastic/go-elasticsearch/actions?query=branch%3Amain)
 
-## Compatibility
+# Compatibility
+
+## Go
+
+Starting from version `8.12.0`, this library follow the Go language [policy](https://go.dev/doc/devel/release#policy). Each major Go release is supported until there are two newer major releases. For example, Go 1.5 was supported until the Go 1.7 release, and Go 1.6 was supported until the Go 1.8 release.
+
+## Elasticsearch
 
 Language clients are forward compatible; meaning that clients support communicating with greater or equal minor versions of Elasticsearch.
 Elasticsearch language clients are only backwards compatible with default distributions and without guarantees made.