[language-translation] updated jsdoc

Author: germanattanasio

services/language_translation/v2.js

@@ -24,9 +24,9 @@ var helper         = require('../../lib/helper');
 
 /**
  *
- * @param {string} [somebody=https://gateway.watsonplatform.net/language-translation/api] The service URL.
- * @param {string} username Username
- * @param {string} password Password
+ * @param {string} [params.url=https://gateway.watsonplatform.net/language-translation/api] The service URL.
+ * @param {string} params.username Username
+ * @param {string} params.password Password
  * @constructor
  */
 function LanguageTranslation(options) {
@@ -43,11 +43,11 @@ function LanguageTranslation(options) {
 
 /**
  * Return the translation models
- * @param  {string}   default   Query filters to check if the model is
+ * @param  {string}   params.default   Query filters to check if the model is
  *                            the default one used when only source
  *                            and target languages are specified.
- * @param  {string}   source   Filter by source language
- * @param  {string}   target   Filter by target language
+ * @param  {string}   params.source   Filter by source language
+ * @param  {string}   params.target   Filter by target language
  */
 LanguageTranslation.prototype.getModels = function(params, callback) {
   params = params || {};
@@ -66,7 +66,7 @@ LanguageTranslation.prototype.getModels = function(params, callback) {
 
 /**
  * Return the translation model
- * @param  {string}   model_id   The model identifier
+ * @param  {string}   params.model_id   The model identifier
  */
 LanguageTranslation.prototype.getModel = function(params, callback) {
   params = params || {};
@@ -86,11 +86,11 @@ LanguageTranslation.prototype.getModel = function(params, callback) {
 
 /**
  * Creates a translation model
- * @param  {string}   base_model_id   The base model identifier
- * @param  {string}   name   The model name
- * @param  {stream}   forced_glossary   A UTF-8 encoded TMX file that contains pairs of matching terms in the source and target language that are seen as absolute by the system. This file completely overwrites the original domain data.
- * @param  {stream}   parallel_corpus   A UTF-8 encoded TMX file that contains matching phrases in the source and target language that serve as examples for Watson. Parallel corpora differ from glossaries because they do not overwrite the original domain data.
- * @param  {stream}   monolingual_corpus A UTF-8 encoded plain text file that contains a body of text in the target language that is related to what you are translating. A monolingual corpus helps improve literal translations to be more fluent and human.
+ * @param  {string}   params.base_model_id   The base model identifier
+ * @param  {string}   params.name   The model name
+ * @param  {stream}   params.forced_glossary   A UTF-8 encoded TMX file that contains pairs of matching terms in the source and target language that are seen as absolute by the system. This file completely overwrites the original domain data.
+ * @param  {stream}   params.parallel_corpus   A UTF-8 encoded TMX file that contains matching phrases in the source and target language that serve as examples for Watson. Parallel corpora differ from glossaries because they do not overwrite the original domain data.
+ * @param  {stream}   params.monolingual_corpus A UTF-8 encoded plain text file that contains a body of text in the target language that is related to what you are translating. A monolingual corpus helps improve literal translations to be more fluent and human.
  */
 LanguageTranslation.prototype.createModel = function(params, callback) {
   params = params || {};
@@ -127,7 +127,7 @@ LanguageTranslation.prototype.createModel = function(params, callback) {
 
 /**
  * Deletes a model
- * @param  {string}   model_id   The model identifier
+ * @param  {string}   params.model_id   The model identifier
  */
 LanguageTranslation.prototype.deleteModel = function(params, callback) {
   params = params || {};
@@ -147,8 +147,8 @@ LanguageTranslation.prototype.deleteModel = function(params, callback) {
 
 /**
  * Translate pharagraphs from one language into another
- * @param {string} source Source language
- * @param {string} target Target language
+ * @param {string} params.source Source language
+ * @param {string} params.target Target language
  */
 LanguageTranslation.prototype.translate = function(params, callback) {
   params = params || {};
@@ -191,7 +191,7 @@ LanguageTranslation.prototype.getIdentifiableLanguages = function(params, callba
 
 /**
  * Identify the text based on the identifiable languages
- * @param  [string]   text   text to identify
+ * @param  {string} params.text  text to identify
  */
 LanguageTranslation.prototype.identify = function(params, callback) {
   if (!params || !params.text){