docs(personality-insights, nlu): Address review comments about docs

Author: lpatino10

natural-language-understanding/src/main/java/com/ibm/watson/developer_cloud/natural_language_understanding/v1/NaturalLanguageUnderstanding.java

@@ -77,25 +77,7 @@ public NaturalLanguageUnderstanding(String versionDate, String username, String
   }
 
   /**
-   * Analyze text, HTML, or a public webpage.
-   *
-   * Analyzes text, HTML, or a public webpage with one or more text analysis features. ### Concepts Identify general
-   * concepts that are referenced or alluded to in your content. Concepts that are detected typically have an associated
-   * link to a DBpedia resource. ### Emotion Detect anger, disgust, fear, joy, or sadness that is conveyed by your
-   * content. Emotion information can be returned for detected entities, keywords, or user-specified target phrases
-   * found in the text. ### Entities Detect important people, places, geopolitical entities and other types of entities
-   * in your content. Entity detection recognizes consecutive coreferences of each entity. For example, analysis of the
-   * following text would count \"Barack Obama\" and \"He\" as the same entity: \"Barack Obama was the 44th President of
-   * the United States. He took office in January 2009.\" ### Keywords Determine the most important keywords in your
-   * content. Keyword phrases are organized by relevance in the results. ### Metadata Get author information,
-   * publication date, and the title of your text/HTML content. ### Relations Recognize when two entities are related,
-   * and identify the type of relation. For example, you can identify an \"awardedTo\" relation between an award and its
-   * recipient. ### Semantic Roles Parse sentences into subject-action-object form, and identify entities and keywords
-   * that are subjects or objects of an action. ### Sentiment Determine whether your content conveys postive or negative
-   * sentiment. Sentiment information can be returned for detected entities, keywords, or user-specified target phrases
-   * found in the text. ### Categories Categorize your content into a hierarchical 5-level taxonomy. For example,
-   * \"Leonardo DiCaprio won an Oscar\" returns \"/art and entertainment/movies and tv/movies\" as the most confident
-   * classification.
+   * Analyze text, HTML, or a public webpage with one or more text analysis features.
    *
    * @param analyzeOptions the {@link AnalyzeOptions} containing the options for the call
    * @return a {@link ServiceCall} with a response type of {@link AnalysisResults}

personality-insights/src/main/java/com/ibm/watson/developer_cloud/personality_insights/v3/PersonalityInsights.java

@@ -83,19 +83,7 @@ public PersonalityInsights(String versionDate, String username, String password)
    *
    * Generates a personality profile for the author of the input text. The service accepts a maximum of 20 MB of input
    * content, but it requires much less text to produce an accurate profile; for more information, see [Providing
-   * sufficient input](https://console.bluemix.net/docs/services/personality-insights/input.html#sufficient). The
-   * service analyzes text in Arabic, English, Japanese, Korean, or Spanish and returns its results in a variety of
-   * languages. You can provide plain text, HTML, or JSON input by specifying the **Content-Type** parameter; the
-   * default is `text/plain`. Request a JSON or comma-separated values (CSV) response by specifying the **Accept**
-   * parameter; CSV output includes a fixed number of columns and optional headers. Per the JSON specification, the
-   * default character encoding for JSON content is effectively always UTF-8; per the HTTP specification, the default
-   * encoding for plain text and HTML is ISO-8859-1 (effectively, the ASCII character set). When specifying a content
-   * type of plain text or HTML, include the `charset` parameter to indicate the character encoding of the input text;
-   * for example: `Content-Type: text/plain;charset=utf-8`. For detailed information about calling the service and the
-   * responses it can generate, see (Requesting a
-   * profile)[https://console.bluemix.net/docs/services/personality-insights/input.html], (Understanding a JSON
-   * profile)[https://console.bluemix.net/docs/services/personality-insights/output.html], and (Understanding a CSV
-   * profile)[https://console.bluemix.net/docs/services/personality-insights/output-csv.html].
+   * sufficient input](https://console.bluemix.net/docs/services/personality-insights/input.html#sufficient).
    *
    * @param profileOptions the {@link ProfileOptions} containing the options for the call
    * @return a {@link ServiceCall} with a response type of {@link Profile}