diff --git a/CHANGES.md b/CHANGES.md
index 5e9e5c112a..a467b942fc 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -44,9 +44,11 @@
 - New OAuth adapter for Box.com
 - New OAuth adapter for PayPal sandbox
 
-## Breaking Changes
+## Breaking Changes (Read before upgrading)
 - **Deprecated** `first` and `last` query params for documents list route in the database API
 - **Deprecated** Deprectaed Pubjabi Translations ('pn')
+- Switched order of limit and offset params in all the SDKs `listDocuments` method for better consistency
+- Default `limit` param value in all the SDKs `listDocuments` method is now 25 for better consistency
 
 ## Security