diff --git a/doc/source/index.rst b/doc/source/index.rst
index afe99c7a..ab747316 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -27,6 +27,7 @@ User guide
    userdoc/installation.guide
    userdoc/configuration.guide
    horizon/installation.guide
+   userdoc/upgrade.guide
 
 **How To**
 
diff --git a/doc/source/userdoc/upgrade.guide.rst b/doc/source/userdoc/upgrade.guide.rst
new file mode 100644
index 00000000..1cbc5e30
--- /dev/null
+++ b/doc/source/userdoc/upgrade.guide.rst
@@ -0,0 +1,10 @@
+Sahara Upgrade Guide
+====================
+
+This page contains some details about upgrading Sahara from one release to
+another like config file updates, db migrations, architecture changes and etc.
+
+Icehouse -> Juno
+----------------
+
+Nothing to do now.