diff --git a/doc/upgrade_guide.rst b/doc/upgrade_guide.rst
new file mode 100644
index 0000000000..79c57496fc
--- /dev/null
+++ b/doc/upgrade_guide.rst
@@ -0,0 +1,11 @@
+===============
+Upgrade guide
+===============
+
+To ease the transition between major releases, the following page describes some of the breaking
+changes between major release and what to change to safely upgrade.
+
+Upgrading from ``astroid`` ``2.x`` to ``3.0``
+---------------------------------------------
+
+- Work in progress
diff --git a/doc/whatsnew.rst b/doc/whatsnew.rst
index e26a3c7b59..b30ebc4fbd 100644
--- a/doc/whatsnew.rst
+++ b/doc/whatsnew.rst
@@ -8,4 +8,5 @@ The "Changelog" contains *all* nontrivial changes to astroid for the current ver
 .. toctree::
    :maxdepth: 2
 
+   upgrade_guide
    changelog