diff --git a/UPGRADING.md b/doc/upgrading.md
similarity index 99%
rename from UPGRADING.md
rename to doc/upgrading.md
index 9f796b8be..72dcd2bb2 100644
--- a/UPGRADING.md
+++ b/doc/upgrading.md
@@ -1,3 +1,5 @@
+# Upgrading
+
 ## Upgrading from 1.x to 2.x
 
 There are no special preparations to be made in advance to upgrading. However,