clean up readme and documentation titles

Change-Id: I75775878f190e65b0eedc6d0d7c9de741a979f78

README.rst

@@ -1,8 +1,9 @@
-=============
- oslo.vmware
-=============
+===================================================
+ oslo.vmware --- VMware support code for OpenStack
+===================================================
 
-The Oslo VMware library provides support for common VMware operations and APIs.
+The Oslo VMware library provides support for common VMware operations
+and APIs.
 
 * License: Apache License, Version 2.0
 * Documentation: http://docs.openstack.org/developer/oslo.vmware

doc/source/index.rst

@@ -1,12 +1,13 @@
-Welcome to oslo.vmware's documentation!
-=======================================
+===================================================
+ oslo.vmware --- VMware support code for OpenStack
+===================================================
 
-Contents:
+The Oslo VMware library provides support for common VMware operations
+and APIs.
 
 .. toctree::
    :maxdepth: 2
 
-   readme
    installation
    usage
    contributing

doc/source/readme.rst

@@ -1 +0,0 @@
-.. include:: ../../README.rst