diff --git a/UPGRADE.md b/UPGRADE.md
new file mode 100644
index 00000000..9f73f9d5
--- /dev/null
+++ b/UPGRADE.md
@@ -0,0 +1,10 @@
+# v1 -> v2
+
+Notable changes:
+
+- **v2** uses [universal coverage reporter](https://github.com/coverallsapp/coverage-reporter) instead of [node-coveralls](https://github.com/nickmerwin/node-coveralls) like in **v1**.
+
+- Option `path-to-lcov` is now deprecated, use `file` instead.
+
+- You can skip `file` option and coveralls will try to find all supported coverage files and combine their data.
+