Merge pull request #53 from ylecleach/master

Dialog node update :

Author: chughts

services/dialog/v1.html

@@ -112,71 +112,73 @@
 </script>
 
 <script type="text/x-red" data-help-name="service-dialog">
-    <p>Watson Dialog Service, Lists available dialogs and runs a conversation against the dialog</p>
+    <p>The IBM Watson Dialog service enables a developer to automate branching conversations between a user and your application. The Dialog service enables your applications to use natural language to automatically respond to user questions, cross-sell and up-sell, walk users through processes or applications, or even hand-hold users through difficult tasks. (<a href="https://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/dialog.html">service documentation</a>)</p>
+
     <p>Use the drop-down menu in the node configuration window to select the required mode.</p>
     <p></p>
-    <p><b>Create Mode</b>.</p>
+    <p><b>Create Mode :</b></p>
     <p>Creates a dialog template. A XML dialog file is required as input. If the dialog is created successfully the dialog id is returned.</p>
-	<p>The file should be provided as msg.dialog_params["file"]</p>
-	<p>The name for the dialog template should be provided as msg.dialog_params["dialog_name"]</p>
-    <p>The dialog id from the service will be returned on <b>msg.dialog</b>.</p>
-    <p><b>Note</b> : the Watson Dialog API support 3 files types : encrypted .mct, .json or .xml</p>
+	<p>The file should be passed in on <code>msg.payload</code> and must be a valid Node.js Buffer.</p>
+        <p>Example of input nodes for the create mode of the Dialog node:</b>.</p>
+    <ul>
+        <li>HTTP Request in binary mode</li>
+        <li>Dropbox node</li>
+        <li>Box node</li>
+    </ul>
+	<p>In addition, a unique name for the dialog template should be provided in input as</p>
+    <pre><code>msg.dialog_params["dialog_name"]</code></pre>
+    <p>The dialog id from the service will be returned on <code>msg.dialog</code>.</p>
+    <p><b>Note</b> : the Watson Dialog API support 3 files types : encrypted .mct, .json or .xml. This node currently supports only .xml</p>
     <p></p>
-    <p><b>List Mode</b>.</p>
+    <p><b>List Mode :</b></p>
     <p>A list of the available dialogs is returned. For each a dialog id is given, this id is needed to 
 	start a conversation.</p>
-    <p>The list from the service will be returned on <b>msg.dialog</b>.</p>
+    <p>The list from the service will be returned on <code>msg.dialog</code>.</p>
     <p></p>
-    <p><b>Start Conversation Mode</b>.</p>
+    <p><b>Start Conversation Mode :</b></p>
     <p>The conversation is started and the introduction salutation from the dialog is returned.</p>
     <p>The Dialog Id can be passed either as a property or through a function</p>	
-	<pre><code>
+	<pre><code>msg.payload="Hello !";
 msg.dialog_params = {};
 msg.dialog_params["dialog_id"] = "dialog id";
-return msg;
-	</code></pre>
+return msg;</code></pre>
 	<p>In addition a client id and a converstion id are returned. These ids are needed to continue a conversation.</p> 
-    <p>The salutation from the service will be returned on <b>msg.dialog</b>.</p>
+    <p>The salutation from the service will be returned on <code>msg.dialog</code>.</p>
     <p></p>
-    <p><b>Conversation Mode</b>.</p>
+    <p><b>Conversation Mode :</b></p>
     <p>The conversation is continued.</p> 
     <p>The Client and Conversation IDs can be passed either as properties or through a function</p>	
-	<pre><code>
+	<pre><code>msg.payload="what type of pizza do you have ?";
 msg.dialog_params = {};
 msg.dialog_params["client_id"] = "client id";
 msg.dialog_params["converse_id"] = "conversation id";
-return msg;
-	</code></pre>	
-    <p>The response from the service will be returned on <b>msg.dialog</b>.</p>
+return msg;</code></pre>	
+    <p>The response from the service will be returned on <code>msg.dialog</code>.</p>
     <p></p>
-    <p><b>List Profile Variables</b>.</p>
+    <p><b>List Profile Variables :</b></p>
     <p>Retrieves the profile variables that the dialog has set during the conversation. These can be
 	used to determine the state of the conversation, and by an applicaiton to perform any further actions.</p> 
     <p>The Dialog, Client and Conversation IDs can be passed either as properties or through a function</p>	
-	<pre><code>
-msg.dialog_params = {};
+	<pre><code>msg.dialog_params = {};
 msg.dialog_params["dialog_id"] = "dialog id";
 msg.dialog_params["client_id"] = "client id";
 msg.dialog_params["converse_id"] = "conversation id";
-return msg;
-	</code></pre>	
-    <p>The response from the service will be returned on <b>msg.dialog</b>.</p>
+return msg;</code></pre>	
+    <p>The response from the service will be returned on <code>msg.dialog</code>.</p>
     <p></p>
-    <p><b>Delete a Dialog</b>.</p>
+    <p><b>Delete a Dialog :</b></p>
     <p>Delete all Dialogs and associated data (conversations, profiles variables). To be used with caution</p>
     <p>The Dialog ID can be passed either as properties or through a function</p> 
-    <pre><code>
-msg.dialog_params = {};
+    <pre><code>msg.dialog_params = {};
 msg.dialog_params["dialog_id"] = "dialog id";
-    return msg;
-    </code></pre>   
+return msg;</code></pre>   
     <p></p>
-    <p><b>Delete a Dialog</b>.</p>
+    <p><b>Delete a Dialog :</b></p>
     <p>Delete a Dialog and all associated data (conversations, profiles variables). </p>
     <p></p>
     <p><b>Delete All Dialogs</b>.</p>
     <p>Delete All Dialogs and all associated data (conversations, profiles variables). </p>
-    <p><b>Notice</b>: to be used with caution</p>
+    <p><b>Notice</b>: the Delete All mode is to be used with caution</p>
     <p></p>
 
     <p>For more information about the Watson Dialog service,