added document conversion example

Author: germanattanasio

README.md

@@ -25,6 +25,7 @@ APIs and SDKs that use cognitive computing to solve complex problems.
       * [Concept Expansion](#concept-expansion)
       * [Concept Insights](#concept-insights)
       * [Dialog](#dialog)
+      * [Document Conversion](#document-conversion)
       * [Language Translation](#language-translation)
       * [Message Resonance](#message-resonance)
       * [Natural Language Classifier](#natural-language-classifier)
@@ -221,12 +222,37 @@ var dialog = watson.dialog({
   version: 'v1'
 });
 
-
 dialog.getDialogs({}, function (err, dialogs) {
-    if (err)
-      console.log('error:', err);
-    else
-      console.log(JSON.stringify(dialogs, null, 2));
+  if (err)
+    console.log('error:', err);
+  else
+    console.log(JSON.stringify(dialogs, null, 2));
+});
+```
+
+### Document Conversion
+
+```javascript
+var watson = require('watson-developer-cloud');
+var fs = require('fs');
+
+var document_conversion = watson.document_conversion({
+  username: '<username>',
+  password: '<password>',
+  version: 'v1-experimental'
+});
+
+// convert a single document
+document_conversion.convert({
+  // (JSON) ANSWER_UNITS, NORMALIZED_HTML, or NORMALIZED_TEXT
+  file: fs.createReadStream('sample-docx.docx'),
+  conversion_target: document_conversion.conversion_target.ANSWER_UNITS
+}, function (err, response) {
+  if (err) {
+    console.error(err);
+  } else {
+    console.log(JSON.stringify(response, null, 2));
+  }
 });
 ```
 

examples/document_conversion.v1-experimental.js

@@ -0,0 +1,23 @@
+'use strict';
+
+var watson = require('watson-developer-cloud');
+var fs = require('fs');
+
+var document_conversion = watson.document_conversion({
+  username: 'INSERT YOUR USERNAME FOR THE SERVICE HERE',
+  password: 'INSERT YOUR PASSWORD FOR THE SERVICE HERE',
+  version: 'v1-experimental'
+});
+
+// convert a single document
+document_conversion.convert({
+  // (JSON) ANSWER_UNITS, NORMALIZED_HTML, or NORMALIZED_TEXT
+  file: fs.createReadStream(__dirname + '/resources/document_conversion/sample-docx.docx'),
+  conversion_target: document_conversion.conversion_target.ANSWER_UNITS
+}, function (err, response) {
+  if (err) {
+    console.error(err);
+  } else {
+    console.log(JSON.stringify(response, null, 2));
+  }
+});

examples/resources/sample-docx.docx

@@ -114,6 +114,8 @@ var watson = {};
   'tone_analyzer',
   'dialog',
   'retrieve_and_rank',
+  'document_conversion',
+
   // deprecated
   'search',
   'language_identification',

lib/index.js

@@ -381,8 +381,6 @@ DocumentConversion.prototype.getBatchDocument = function(params, callback) {
 /**
  * Creates a job to convert a batch of documents
  *
- * todo: config (?)
- *
  * @param params.name
  * @param params.batch_id
  * @param params.conversion_target