diff --git a/CHANGES/1143.docs.rst b/CHANGES/1143.docs.rst
new file mode 100644
index 00000000..5c4fea5b
--- /dev/null
+++ b/CHANGES/1143.docs.rst
@@ -0,0 +1 @@
+Improved docs, added basic migration guide (will be expanded later)