diff --git a/README.md b/README.md
index 1e178cb..088ccc9 100644
--- a/README.md
+++ b/README.md
@@ -56,7 +56,9 @@ JSURL:
 ``` javascript
 var JSURL = require("jsurl");
 
+//Creates a String like '~(name~'John*20Doe~age~42~children~(~'Mary~'Bill))'
 str = JSURL.stringify(obj);
+//Creates an Object like '{"name":"John Doe","age":42,"children":["Mary","Bill"]}' 
 obj = JSURL.parse(str);
 
 // return def instead of throwing on error