diff --git a/doc/source/user/upgrade.rst b/doc/source/user/upgrade.rst
index 0eb0ef056380..45dcf1c47698 100644
--- a/doc/source/user/upgrade.rst
+++ b/doc/source/user/upgrade.rst
@@ -125,11 +125,11 @@ same time.
 
    * This process can put significant extra write load on the
      database.  Complete all online data migrations using:
-     ``nova-manage db online_data_migrations --limit <number>``. Note
-     that you can use the limit argument to reduce the load this
+     ``nova-manage db online_data_migrations --max-count <number>``. Note
+     that you can use the ``--max-count`` argument to reduce the load this
      operation will place on the database, which allows you to run a
      small chunk of the migrations until all of the work is done. Each
-     time it is run, it will show summary of completed and remaining
+     time it is run, it will show a summary of completed and remaining
      records. You run this command until you see completed and
      remaining records as zeros. The chunk size you should use depend
      on your infrastructure and how much additional load you can