diff --git a/README.md b/README.md
index 560de99..562f706 100644
--- a/README.md
+++ b/README.md
@@ -312,6 +312,20 @@ poetry run black .
 poetry run flake8
 ```
 
+## Breaking Changes
+
+### Version 1.0.0
+
+- output format is now a list of typed result. (Before it was a Tuple[dict, list[dict]]) that represent parsed values and errors).
+### Version 0.16.0
+
+- **Python 3.12+ required**: Upgraded from Python 3.11 to Python 3.12. Update your Python environment before upgrading.
+
+### Version 0.15.0
+
+- **Python 3.11+ required**: Upgraded from Python 3.10 to Python 3.11. Update your Python environment before upgrading.
+
+
 ## License
 
 This project is licensed under the MIT License.