diff --git a/doc/user-guide/source/cli_create_and_manage_stacks.rst b/doc/user-guide/source/cli_create_and_manage_stacks.rst
index 5b06c22d49..47dcb48295 100644
--- a/doc/user-guide/source/cli_create_and_manage_stacks.rst
+++ b/doc/user-guide/source/cli_create_and_manage_stacks.rst
@@ -47,6 +47,13 @@ Create a stack from an example template file
       | 4c712026-dcd5... | mystack       | CREATE_IN_PROGRESS | 2013-04-03T23:22:08Z |
       +------------------+---------------+--------------------+----------------------+
 
+   .. note::
+
+      When you run the :command:`heat stack-create` command with the
+      :option:`--poll` option, it prints the :command:`heat stack-show`
+      output first, and then continously prints the events in log format
+      until the stack completes its action with success or failure.
+
 -  You can also use the :command:`template-validate` command to validate a
    template file without creating a stack from it.