diff --git a/doc/source/man/nova-cells.rst b/doc/source/man/nova-cells.rst
index 8ee5944d8087..0b12d25cbbd2 100644
--- a/doc/source/man/nova-cells.rst
+++ b/doc/source/man/nova-cells.rst
@@ -23,7 +23,12 @@ DESCRIPTION
 
 Starts the nova-cells service.
 
-The nova-cells service handles communication between cells and selects cells for new instances.
+The nova-cells service handles communication between cells and selects cells
+for new instances.
+
+.. warning:: Everything in this document is referring to Cells v1, which is
+    not recommended for new deployments. For information about commands to use
+    with Cells v2, see the man page for :ref:`man-page-cells-v2`.
 
 OPTIONS
 =======
diff --git a/doc/source/man/nova-manage.rst b/doc/source/man/nova-manage.rst
index afcdd6f4b0b1..2bc6c41a74d5 100644
--- a/doc/source/man/nova-manage.rst
+++ b/doc/source/man/nova-manage.rst
@@ -76,6 +76,8 @@ Nova API Database
 
     Sync the api cells database up to the most recent version. This is the standard way to create the db as well.
 
+.. _man-page-cells-v2:
+
 Nova Cells v2
 ~~~~~~~~~~~~~