summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/upgrade_guide.rst11
-rw-r--r--doc/whatsnew.rst1
2 files changed, 12 insertions, 0 deletions
diff --git a/doc/upgrade_guide.rst b/doc/upgrade_guide.rst
new file mode 100644
index 00000000..79c57496
--- /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 e26a3c7b..b30ebc4f 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