change the written way of the doc

JIRA: BOTTLENECK-23

document improvement

Change-Id: I3b33bbb3e8948ec6ca3957f0d7f08234a4fbc649
Signed-off-by: MatthewLi <matthew.lijun@huawei.com>

2 files changed, 55 insertions, 11 deletions

diff --git a/utils/infra_setup/README.rst b/utils/infra_setup/README.rst
index b6076eb9..0b6dc40e 100644
--- a/utils/infra_setup/README.rst
+++ b/utils/infra_setup/README.rst
@@ -1,4 +1,12 @@
-==================
+..
+.. image:: ../etc/opnfv-logo.png
+  :height: 40
+  :width: 200
+  :alt: OPNFV
+  :align: left
+..
+|
+|
 Infra Setup Guide
 ==================
 
@@ -28,27 +36,33 @@ Parameter $OPENRC_PATH is the path of where your admin-openrc.sh located, which
 Add Floating IPs for the Instances
 ===================================
 
-Check the available floating IPs::
+Check the available floating IPs
+
+.. code-block:: bash
+
+    nova floating-ip-list
+
+Check the status of the instances created
 
- nova floating-ip-list
+.. code-block:: bash
 
-Check the status of the instances created::
+    nova list
 
- nova list
+If there're no available floating IPs, to create one
 
-If there're no available floating IPs, to create one::
+.. code-block:: bash
 
- nova floating-ip-create <ext_net_name>
+    nova floating-ip-create <ext_net_name>
 
 replace <ext_net_name> with the external network in your environment.
 
-Associate the floating IP address with the instance::
+Associate the floating IP address with the instance
 
- nova add-floating-ip <instance name or ID> <allocated_floating_IP>
+.. code-block:: bash
 
+    nova add-floating-ip <instance name or ID> <allocated_floating_IP>
 
-**Documentation tracking**
 
 Revision: _sha1_
 
-Build date:  _date_
+Build date:  |today|
diff --git a/utils/infra_setup/index.rst b/utils/infra_setup/index.rst
new file mode 100644
index 00000000..e8b7fc64
--- /dev/null
+++ b/utils/infra_setup/index.rst
@@ -0,0 +1,30 @@
+.. OPNFV Release Engineering documentation, created by
+   sphinx-quickstart on Tue Jun  9 19:12:31 2015.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+.. image:: ../etc/opnfv-logo.png
+  :height: 40
+  :width: 200
+  :alt: OPNFV
+  :align: left
+
+Documentation table of contents for infra_setup
+===============================================
+
+Contents:
+
+.. toctree::
+   :numbered:
+   :maxdepth: 4
+
+   README.rst
+
+Indices and tables
+==================
+
+* :ref:`search`
+
+Revision: _sha1_
+
+Build date: |today|