Merge "Update using openstack section of quickstart"

doc/source/user/quickstart.rst

@@ -502,47 +502,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
+
+      pip install python-openstackclient python-glanceclient python-neutronclient
+
+   .. end
+
+#. OpenStack requires an openrc file where credentials for admin user
+   are set. To generate this file:
+
+   * For deployment or evaluation, run:
+
+     .. code-block:: console
 
         kolla-ansible post-deploy
         . /etc/kolla/admin-openrc.sh
 
-.. end
+     .. end
 
-Install basic OpenStack CLI clients:
+   * For development, run:
 
-.. code-block:: console
+     .. code-block:: console
 
-   pip install python-openstackclient python-glanceclient python-neutronclient
+        cd kolla-ansible/tools
+        ./kolla-ansible post-deploy
+        . /etc/kolla/admin-openrc.sh
 
-.. end
+     .. end
 
-Depending on how you installed Kolla-Ansible, there is script that will create
-example networks, images, and so on.
+#. Depending on how you installed Kolla-Ansible, there is a script that will
+   create example networks, images, and so on.
 
-For pip install and CentOS host:
+   * For deployment or evaluation,
+     run ``init-runonce`` script on CentOS:
 
-.. code-block:: console
+     .. code-block:: console
 
         . /usr/share/kolla-ansible/init-runonce
 
-.. end
+     .. end
 
-For pip install and Ubuntu host:
+     Run ``init-runonce`` script on Ubuntu:
 
-.. code-block:: console
+     .. code-block:: console
 
         . /usr/local/share/kolla-ansible/init-runonce
 
-.. end
+     .. end
 
-For git pulled source:
+   * For development, run:
 
-.. code-block:: console
+     .. code-block:: console
 
         . kolla-ansible/tools/init-runonce
 
-.. end
+     .. end