Add README.md

2 files changed, 17 insertions, 1 deletions

diff --git a/README.md b/README.md
index e69de29..b3a65b9 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,16 @@
+# jq.py: a lightweight and flexible JSON processor
+
+Warning: this project is not production-ready.
+There are almost certainly a number of memory leaks and the API is not stable.
+
+This project contains Python bindings for (jq)[http://stedolan.github.io/jq/].
+
+## Examples
+
+```python
+from jq import jq
+
+assert [2, 3, 4] == jq("[.[]+1]").transform_json([1, 2, 3]).json()
+assert [2,3,4] == str(jq("[.[]+1]").transform_json([1, 2, 3]))
+assert [2,3,4] == str(jq("[.[]+1]").transform_string("[1, 2, 3]"))
+```
diff --git a/setup.py b/setup.py
index 3075d2d..dd4911a 100644
--- a/setup.py
+++ b/setup.py
@@ -53,7 +53,7 @@ jq_extension = Extension(
 setup(
     name='jq',
     version='0.1.0',
-    description='jq is a lightweight and flexible command-line JSON processor.',
+    description='jq is a lightweight and flexible JSON processor.',
     long_description=read("README"),
     author='Michael Williamson',
     url='http://github.com/mwilliamson/jq.py',