ansible · AaronH88 · Mar 11, 2024 · Mar 6, 2024 · Mar 6, 2024 · Mar 6, 2024
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -18,4 +18,5 @@ Receptor is an overlay network intended to ease the distribution of work across
    developer_guide
    porting_guide/index
    roadmap/index
+   upgrade/index
    contributing
diff --git a/docs/source/upgrade/UPGRADE_2.rst b/docs/source/upgrade/UPGRADE_2.rst
@@ -0,0 +1,10 @@
+==========
+Receptor 2
+==========
+
+To upgrade an existing Receptor installation to the latest version, follow the instructions in :ref:`installing`
+
+
+.. contents::
+   :local:
+
diff --git a/docs/source/upgrade/index.rst b/docs/source/upgrade/index.rst
@@ -0,0 +1,5 @@
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   receptor_upgrade_index
diff --git a/docs/source/upgrade/receptor_upgrade_index.rst b/docs/source/upgrade/receptor_upgrade_index.rst
@@ -0,0 +1,15 @@
+=================
+Receptor Upgrades
+=================
+
+You can submit feedback on the upgrade guides in multiple ways:
+- Create issue on github in ansible/receptor
+
+Go to `Ansible forum <https://forum.ansible.com/>`_ to join the community discussions.
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+   :caption: Receptor Upgrade Guides
+
+   UPGRADE_2