diff --git a/docs/@v2/guides/migrate-to-v2.md b/docs/@v2/guides/migrate-to-v2.md
index 17cbf0ac65..a4613911f2 100644
--- a/docs/@v2/guides/migrate-to-v2.md
+++ b/docs/@v2/guides/migrate-to-v2.md
@@ -90,7 +90,7 @@ You may refer to [this Cookbook recipe](https://github.com/Redocly/redocly-cli-c
 Removed rule `info-license-url`.
 Use `info-license-strict` which better complies with the new [OpenAPI 3.1 specification](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#license-object).
 
-### Assertion changes
+### Configurable rules changes
 
 The `undefined` assertion has been removed:
 
@@ -135,6 +135,34 @@ extends:
 
 The `no-duplicated-tag-names` rule checks for duplicate tag names in your API description.
 
+### JSON schema format validation
+
+Now Redocly CLI supports JSON schema formats:
+
+```yaml
+openapi: 3.1.0
+paths:
+  /users/{id}:
+    get:
+      responses:
+        200:
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  email:
+                    type: string
+                    format: email
+              examples:
+                Correct:
+                  value:
+                    email: correct@email.com
+                Incorrect:
+                  value:
+                    email: wrong-email # Will fail validation
+```
+
 ## Migration checklist
 
 1. **Update Node.js** to a supported version (20.19.0+, 22.12.0+, or 23+).