diff --git a/odoo/openupgrade/doc/source/migrate.py.rst b/odoo/openupgrade/doc/source/migrate.py.rst
index 095b033a1361..6d1ea92e125f 100644
--- a/odoo/openupgrade/doc/source/migrate.py.rst
+++ b/odoo/openupgrade/doc/source/migrate.py.rst
@@ -4,6 +4,11 @@ Automated migration script
 Introduction
 ------------
 
+**note that the original maintainer of this script deprecated this in favor
+of a dedicated buildout as described in
+https://github.com/OCA/OpenUpgrade/issues/502, at the moment, this script
+won't be able to migrate to versions above 9.0**
+
 For users who just want to run a migration, there is the convenience script
 migrate.py that takes care of downloading the necessary branches, set up a
 configuration for the migration and passing the correct parameters to the
diff --git a/scripts/build_openupgrade_docs b/scripts/build_openupgrade_docs
index 8ded569530b2..8f1dd7d82e0a 100644
--- a/scripts/build_openupgrade_docs
+++ b/scripts/build_openupgrade_docs
@@ -5,7 +5,7 @@ DOC_PARTS="6.0|bin/openupgrade/doc
 6.1|openerp/openupgrade/doc
 7.0|openerp/openupgrade/doc
 8.0|openerp/openupgrade/doc
-9.0|openerp/openupgrade/doc"
+9.0|openerp/openupgrade/doc
 10.0|odoo/openupgrade/doc"
 OUTPUT_DIR=${OUTPUT_DIR:-$DOC_BUILD_BASE_DIR/doc}
 DOC_BUILD_DIR=$(mktemp -d)