revise readme with a project description

Change-Id: Ifc43ecbd1034172a71c7f12a2433be5e6224ec01

1 files changed, 12 insertions, 7 deletions

diff --git a/README.rst b/README.rst
index 36e57d9..8e1f3f5 100644
--- a/README.rst
+++ b/README.rst
@@ -1,11 +1,16 @@
-========
- PyCADF
-========
+======
+PyCADF
+======
 
-see the ReleaseNotes document and the project home for more info.
+This library provides an auditing data model based on the `Cloud Auditing Data
+Federation <http://www.dmtf.org/standards/cadf>`_ specification, primarily for
+use by OpenStack.
 
-  http://launchpad.net/pycadf
+Developer documentation, the source of which is in ``doc/source/``, is
+published at:
 
-Specification details can be found here: http://www.dmtf.org/standards/cadf
+    http://docs.openstack.org/developer/pycadf
 
-Developer details can be found here: http://docs.openstack.org/developer/pycadf
\ No newline at end of file
+Bugs and feature requests are tracked on Launchpad at:
+
+    https://bugs.launchpad.net/pycadf