From 47e2b6221bb4d11f56d9b08e6098ca5557350c5a Mon Sep 17 00:00:00 2001
From: chenxing <chason.chan@foxmail.com>
Date: Thu, 10 May 2018 17:20:58 +0800
Subject: [PATCH] Update using openstack section of quickstart

Change-Id: I0e3c098db9d1f0a8fda383910c05ed5efc929994
---
 doc/source/user/quickstart.rst | 61 +++++++++++++++++++++-------------
 1 file changed, 37 insertions(+), 24 deletions(-)

diff --git a/doc/source/user/quickstart.rst b/doc/source/user/quickstart.rst
index dfde1a6548..989598192f 100644
--- a/doc/source/user/quickstart.rst
+++ b/doc/source/user/quickstart.rst
@@ -501,47 +501,60 @@ If error occurs during execution, refer to
 Using OpenStack
 ~~~~~~~~~~~~~~~
 
-OpenStack requires an openrc file where credentials for admin user etc are set.
-To generate this file run
+#. Install basic OpenStack CLI clients:
 
-.. code-block:: console
+   .. code-block:: console
 
-   kolla-ansible post-deploy
-   . /etc/kolla/admin-openrc.sh
+      pip install python-openstackclient python-glanceclient python-neutronclient
 
-.. end
+   .. end
 
-Install basic OpenStack CLI clients:
+#. OpenStack requires an openrc file where credentials for admin user
+   are set. To generate this file:
 
-.. code-block:: console
+   * For deployment or evaluation, run:
 
-   pip install python-openstackclient python-glanceclient python-neutronclient
+     .. code-block:: console
 
-.. end
+        kolla-ansible post-deploy
+        . /etc/kolla/admin-openrc.sh
 
-Depending on how you installed Kolla-Ansible, there is script that will create
-example networks, images, and so on.
+     .. end
 
-For pip install and CentOS host:
+   * For development, run:
 
-.. code-block:: console
+     .. code-block:: console
 
-   . /usr/share/kolla-ansible/init-runonce
+        cd kolla-ansible/tools
+        ./kolla-ansible post-deploy
+        . /etc/kolla/admin-openrc.sh
 
-.. end
+     .. end
 
-For pip install and Ubuntu host:
+#. Depending on how you installed Kolla-Ansible, there is a script that will
+   create example networks, images, and so on.
 
-.. code-block:: console
+   * For deployment or evaluation,
+     run ``init-runonce`` script on CentOS:
 
-   . /usr/local/share/kolla-ansible/init-runonce
+     .. code-block:: console
 
-.. end
+        . /usr/share/kolla-ansible/init-runonce
 
-For git pulled source:
+     .. end
 
-.. code-block:: console
+     Run ``init-runonce`` script on Ubuntu:
 
-   . kolla-ansible/tools/init-runonce
+     .. code-block:: console
 
-.. end
+        . /usr/local/share/kolla-ansible/init-runonce
+
+     .. end
+
+   * For development, run:
+
+     .. code-block:: console
+
+        . kolla-ansible/tools/init-runonce
+
+     .. end