diff --git a/doc/upgrade.md b/doc/upgrade.md
new file mode 100644
index 00000000..ef2effdc
--- /dev/null
+++ b/doc/upgrade.md
@@ -0,0 +1,4 @@
+* merge upstream, update flake
+* update src
+* fix all build errors
+* update modules