diff --git a/doc/source/install/developer/developer.rst b/doc/source/install/developer/developer.rst
index 49c92752..ee9a3743 100644
--- a/doc/source/install/developer/developer.rst
+++ b/doc/source/install/developer/developer.rst
@@ -8,4 +8,5 @@ Documentation of developer-specific options in |project|.
 
    tripleo.sh
    tht_walkthrough/tht_walkthrough
+   upgrades/upgrades
    release
diff --git a/doc/source/install/developer/upgrades/ci_upgrades.rst b/doc/source/install/developer/upgrades/ci_upgrades.rst
new file mode 100644
index 00000000..2531b7e8
--- /dev/null
+++ b/doc/source/install/developer/upgrades/ci_upgrades.rst
@@ -0,0 +1,24 @@
+.. TODO: This is a template which is being
+   completed. The subsections stated
+   here might differ from the ones in the
+   final version.
+
+Major upgrades/Minor upgrades CI coverage
+-----------------------------------------
+
+Upgrades CI jobs
+~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
+How to add a new upgrade/update job in the CI
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
+Debugging CI jobs
+~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
+Replicating CI jobs
+~~~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
diff --git a/doc/source/install/developer/upgrades/collab_upgrades.rst b/doc/source/install/developer/upgrades/collab_upgrades.rst
new file mode 100644
index 00000000..efc7ea08
--- /dev/null
+++ b/doc/source/install/developer/upgrades/collab_upgrades.rst
@@ -0,0 +1,16 @@
+.. TODO: This is a template which is being
+   completed. The subsections stated
+   here might differ from the ones in the
+   final version.
+
+How to collaborate to the upgrades/updates workflow
+---------------------------------------------------
+
+Relevant repositories
+~~~~~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
+Guide: Implementing keystone upgrade steps
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
diff --git a/doc/source/install/developer/upgrades/fast_fw_upgrade.rst b/doc/source/install/developer/upgrades/fast_fw_upgrade.rst
new file mode 100644
index 00000000..d1a55b67
--- /dev/null
+++ b/doc/source/install/developer/upgrades/fast_fw_upgrade.rst
@@ -0,0 +1,12 @@
+.. TODO: This is a template which is being
+   completed. The subsections stated
+   here might differ from the ones in the
+   final version.
+
+Fast forward upgrade (N -> N+3) in TripleO
+----------------------------------------------------
+
+Tutorial: Fast forward upgrade from Newton to Queens
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
diff --git a/doc/source/install/developer/upgrades/major_upgrade.rst b/doc/source/install/developer/upgrades/major_upgrade.rst
new file mode 100644
index 00000000..71136636
--- /dev/null
+++ b/doc/source/install/developer/upgrades/major_upgrade.rst
@@ -0,0 +1,20 @@
+.. TODO: This is a template which is being
+   completed. The subsections stated
+   here might differ from the ones in the
+   final version.
+
+Upgrade to a major release in TripleO
+-------------------------------------
+
+Major upgrade workfow
+~~~~~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
+Tutorial: Upgrade from Pike to Queens
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
+Tutorial: Upgrade from Ocata to Pike
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
diff --git a/doc/source/install/developer/upgrades/minor_update.rst b/doc/source/install/developer/upgrades/minor_update.rst
new file mode 100644
index 00000000..20446d45
--- /dev/null
+++ b/doc/source/install/developer/upgrades/minor_update.rst
@@ -0,0 +1,16 @@
+.. TODO: This is a template which is being
+   completed. The subsections stated
+   here might differ from the ones in the
+   final version.
+
+Update to a minor release in TripleO
+-------------------------------------
+
+Minor update workfow
+~~~~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
+Tutorial: Minor update
+~~~~~~~~~~~~~~~~~~~~~~
+# WORK IN PROGRESS
+
diff --git a/doc/source/install/developer/upgrades/upgrades.rst b/doc/source/install/developer/upgrades/upgrades.rst
new file mode 100644
index 00000000..d4ba54a3
--- /dev/null
+++ b/doc/source/install/developer/upgrades/upgrades.rst
@@ -0,0 +1,17 @@
+Major Upgrade/Minor update developer documentation
+==================================================
+
+This section is intended to give a better understanding of the upgrade/update
+process in TripleO. As well as a walkthrough for developers on the way upgrade
+workflow enables OpenStack services upgrade.
+
+# WORK IN PROGRESS: Intended for Queens release
+
+.. toctree::
+   :maxdepth: 2
+
+   major_upgrade
+   minor_update
+   fast_fw_upgrade
+   ci_upgrades
+   collab_upgrades