diff --git a/README.rst b/README.rst
index c117cd2..ee40d27 100644
--- a/README.rst
+++ b/README.rst
@@ -1,6 +1,6 @@
-=========
- oslo.db
-=========
+===============================================
+ oslo.db -- OpenStack Database Pattern Library
+===============================================
 
 .. image:: https://img.shields.io/pypi/v/oslo.db.svg
     :target: https://pypi.python.org/pypi/oslo.db/
@@ -10,8 +10,9 @@
     :target: https://pypi.python.org/pypi/oslo.db/
     :alt: Downloads
 
-The oslo db (database) handling library, it provides database connectivity
-to different database backends and various other helper utils.
+The oslo db (database) handling library, provides database
+connectivity to different database backends and various other helper
+utils.
 
 * Free software: Apache license
 * Documentation: http://docs.openstack.org/developer/oslo.db
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 6532cf8..de4d909 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -1,9 +1,10 @@
-===================================
-Welcome to oslo.db's documentation!
-===================================
+===============================================
+ oslo.db -- OpenStack Database Pattern Library
+===============================================
 
-The `oslo`_ db (database) handling library, it provides database connectivity
-to different database backends and various other helper utils.
+The oslo.db (database) handling library, provides database
+connectivity to different database backends and various other helper
+utils.
 
 .. toctree::
    :maxdepth: 2
@@ -28,5 +29,3 @@ Indices and tables
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
-
-.. _oslo: https://wiki.openstack.org/wiki/Oslo