diff --git a/README.md b/README.md
index 8465820c3..9b2de1998 100644
--- a/README.md
+++ b/README.md
@@ -212,7 +212,7 @@ Contracts addresses can be defined, If an address is defined the contract wouldn
       },
       "UserManagement": {
         "args": [
-          "\$UserStorage"
+          "$UserStorage"
         ]
       }
     }
@@ -226,6 +226,10 @@ EmbarkJS
 
 EmbarkJS is a javascript library meant to abstract and facilitate the development of DApps.
 
+** promises **
+
+methods in EmbarkJS contracts will be converted to promises
+
 ```Javascript
   var myContract = new EmbarkJS.Contract({abi: abiObject, address: "0x123"});
   myContract.get().then(function(value) { console.log("value is " + value.toNumber) });