[Docs] Guide users more

- It's easy for a new deployer to miss the importance of the
  configuration. This highlights the step.
- It makes more sense to be guided from the deploy-guide to
  the Operations guide first, before the contributing.
- Reduced the commands to run for a first verification of
  the cloud.

Change-Id: I7bc7dce2d4a9f0449a3f70cc2717f5e0a8345dc4

deploy-guide/source/configure.rst

@@ -78,6 +78,14 @@ OpenStack-Ansible has many options that you can use for the advanced
 configuration of services. Each role's documentation provides information
 about the available options.
 
+.. important::
+
+   This step is essential to tailoring OpenStack-Ansible to your needs
+   and is generally overlooked by new deployers. Have a look at each
+   role documentation, user guides, and reference if you want a tailor
+   made cloud.
+
+
 Infrastructure service roles
 ----------------------------
 

deploy-guide/source/next-steps.rst

@@ -5,14 +5,14 @@ Next steps
 Now that you have verified that your OpenStack cloud
 is working, here is what you can do next:
 
-Contribute to OpenStack-Ansible
-===============================
-
-If you want to contribute to OpenStack-Ansible, please
-have a look at our `Contributors guide <https://docs.openstack.org/openstack-ansible/latest/contributor/index.html>`_.
-
-
 Operate OpenStack-Ansible
 =========================
 
-Have a look at our `Operations guide <https://docs.openstack.org/openstack-ansible/latest/admin/index.html>`_.
+Review our `Operations guide <https://docs.openstack.org/openstack-ansible/latest/admin/index.html>`_
+to learn about verifying your environment in more detail, and creating your first networks, images, and instances.
+
+Contribute to OpenStack-Ansible
+===============================
+
+Review our `Contributors guide <https://docs.openstack.org/openstack-ansible/latest/contributor/index.html>`_
+to learn about contributing to OpenStack-Ansible.

deploy-guide/source/verify-operation.rst

@@ -29,17 +29,11 @@ configuration and testing.
 
       # lxc-attach -n infra1_utility_container-161a4084
 
-#. Source the ``admin`` tenant credentials:
+#. List your openstack users:
 
    .. code-block:: console
 
-      # source /root/openrc
+      # openstack user list --os-cloud=default
-
-#. Run an OpenStack command that uses one or more APIs. For example:
-
-   .. code-block:: console
-
-      # openstack user list
       +----------------------------------+--------------------+
       | ID                               | Name               |
       +----------------------------------+--------------------+
@@ -60,7 +54,7 @@ configuration and testing.
       +----------------------------------+--------------------+
 
 Verifying the Dashboard (horizon)
----------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 #. With a web browser, access the Dashboard by using the external load
    balancer IP address defined by the ``external_lb_vip_address`` option