From b79bb97cdea79f8c61f40994a950c445e9bcf185 Mon Sep 17 00:00:00 2001
From: Michel Weststrate <mweststrate@gmail.com>
Date: Sat, 2 Feb 2019 20:38:20 +0100
Subject: [PATCH] BREAKING CHANGE: added migration guide

---
 readme.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/readme.md b/readme.md
index 3cc2bc59..1cb0dcfc 100644
--- a/readme.md
+++ b/readme.md
@@ -711,6 +711,12 @@ Most important observation:
 -   Generating patches doesn't significantly slow immer down
 -   The ES5 fallback implementation is roughly twice as slow as the proxy implementation, in some cases worse.
 
+## Migration
+
+**Immer 1.\* -> 2.0**
+
+Make sure you don't return any promises as state, because `produce` will actually invoke the promise and wait until it settles.
+
 ## FAQ
 
 _(for those who skimmed the above instead of actually reading)_