diff --git a/README.md b/README.md
index 6e2edae7f..3fa98e19b 100644
--- a/README.md
+++ b/README.md
@@ -49,7 +49,7 @@ Table of Contents
 * [Testing Contracts](#tests)
 * [Working with different chains](#working-with-different-chains)
 * [Custom Application Structure](#structuring-application)
-* [Deploying to IPFS](#deploying-to-ipfs)
+* [Deploying to IPFS](#deploying-to-ipfs-and-swarm)
 * [Extending Functionality with Plugins](#plugins)
 * [Donations](#donations)
 
@@ -145,8 +145,11 @@ DApp Structure
     |___ css/
     |___ js/
   config/
-    |___ blockchain.json #environments configuration
-    |___ contracts.json  #contracts configuration
+    |___ blockchain.json #rpc and blockchain configuration
+    |___ contracts.json  #ethereum contracts configuration
+    |___ storage.json  #ipfs configuration
+    |___ communication.json  #whisper/orbit configuration
+    |___ webserver.json  #dev webserver configuration
   test/
     |___ #contracts tests
 ```
@@ -323,14 +326,20 @@ events:
 Client side deployment will be automatically available in Embark for existing contracts:
 
 ```Javascript
-  SimpleStorage.deploy().then(function(anotherSimpleStorage) {});
+  SimpleStorage.deploy([args], {options}).then(function(anotherSimpleStorage) {});
 ```
 
 or it can be manually definied as
 
 ```Javascript
   var myContract = new EmbarkJS.Contract({abi: abiObject, code: code});
-  myContract.deploy().then(function(anotherMyContractObject) {});
+  myContract.deploy([args], {options}).then(function(anotherMyContractObject) {});
+```
+
+so you can define your gas as
+
+```Javascript
+  myContract.deploy([100, "seconde argument"], {gas: 800000}).then(function(anotherMyContractObject) {});
 ```
 
 EmbarkJS - Storage
diff --git a/docs/embarkjs.rst b/docs/embarkjs.rst
index 50c0e7474..dd6a39fcc 100644
--- a/docs/embarkjs.rst
+++ b/docs/embarkjs.rst
@@ -20,11 +20,17 @@ existing contracts:
 
 .. code:: javascript
 
-      SimpleStorage.deploy().then(function(anotherSimpleStorage) {});
+      SimpleStorage.deploy([args], {options}).then(function(anotherSimpleStorage) {});
 
 or it can be manually definied as
 
 .. code:: javascript
 
       var myContract = new EmbarkJS.Contract({abi: abiObject, code: code});
-      myContract.deploy().then(function(anotherMyContractObject) {});
+      myContract.deploy([args], {options}).then(function(anotherMyContractObject) {});
+
+so you can define your gas as
+
+.. code:: javascript
+
+      myContract.deploy([100, "seconde argument"], {gas: 800000}).then(function(anotherMyContractObject) {});