WIP

README.rst

@@ -1,22 +1,30 @@
-python-:green:`arango`
-----------------------
+.. image:: https://cloud.githubusercontent.com/assets/2701938/17721379/c03ec674-63f7-11e6-8aea-d669a68ceaca.jpg
+    :alt: HTTPie compared to cURL
+    :width: 679
+    :height: 781
+    :align: center
 
-Python driver for ArangoDB_ HTTP REST API.
+python-arango
+-----------------
 
-.. _ArangoDB: https://www.arangodb.com
+Python driver for `ArangoDB <https://www.arangodb.com>`_
 
 Overview
 ========
 
-**python-arango** is a Python driver for ArangoDB_ REST API.
-
-    - ArangoDB version 3.x
-    - Python versions 2.7.x, 3.4.x and 3.5.x.
-
-.. note::
-    Version 3.x of python-arango is **not** backwards compatible with
-    ArangoDB versions 2.8.x and under
+**Python-Arango** is a driver for ArangoDB's REST API
 
+    **Features:**
+
+        - Clean, Pythonic API
+        - Lightweight
+        - Robust documentation
+        - 95% API coverage
+
+    **Compatible with:**
+
+        - ArangoDB version *3.0.x*
+        - Python *2.7.x*, *3.4.x* and *3.5.x*
 
 Installation
 ============
@@ -35,10 +43,14 @@ To install the latest version directly from GitHub_:
 
     git clone https://github.com/joowani/python-arango.git
     cd python-arango
+    
     # You may need to use sudo depending on your environment
-    python2.7 setup.py install
+    python setup.py install
 
 .. _PyPi: https://pypi.python.org/pypi/python-arango
 .. _GitHub: https://github.com/joowani/python-arango
 
+Getting Started
+===============
 
+Please view the full documentation for more details.