docs(Discovery): Update method comments

Author: lpatino10

discovery/src/main/java/com/ibm/watson/developer_cloud/discovery/v1/model/QueryResponse.java

@@ -83,6 +83,8 @@ public Long getDuplicatesRemoved() {
    * The session token for this query. The session token can be used to add events associated with this query to the
    * query and event log.
    *
+   * **Important:** Session tokens are case sensitive.
+   *
    * @return the sessionToken
    */
   public String getSessionToken() {

discovery/src/main/java/com/ibm/watson/developer_cloud/discovery/v1/model/QueryResultResultMetadata.java

@@ -25,7 +25,8 @@ public class QueryResultResultMetadata extends GenericModel {
   /**
    * Gets the score.
    *
-   * The raw score of the result. A higher score indicates a greater match to the query parameters.
+   * An unbounded measure of the relevance of a particular result, dependent on the query and matching document. A
+   * higher score indicates a greater match to the query parameters.
    *
    * @return the score
    */
@@ -36,7 +37,9 @@ public Double getScore() {
   /**
    * Gets the confidence.
    *
-   * The confidence score of the result's analysis. A higher score indicates greater confidence.
+   * The confidence score for the given result. Calculated based on how relevant the result is estimated to be, compared
+   * to a trained relevancy model. confidence can range from `0.0` to `1.0`. The higher the number, the more relevant
+   * the document.
    *
    * @return the confidence
    */

discovery/src/main/java/com/ibm/watson/developer_cloud/discovery/v1/model/Timeslice.java

@@ -47,7 +47,7 @@ public String getInterval() {
   /**
    * Gets the anomaly.
    *
-   * Used to inducate that anomaly detection should be performed. Anomaly detection is used to locate unusual datapoints
+   * Used to indicate that anomaly detection should be performed. Anomaly detection is used to locate unusual datapoints
    * within a time series.
    *
    * @return the anomaly