fix(services): update comments and formatting changes

Author: nan2iz

Scripts/Services/Assistant/V1/AssistantService.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2019, 2021.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -16,7 +16,7 @@
 */
 
 /**
-* IBM OpenAPI SDK Code Generator Version: 99-SNAPSHOT-902c9336-20210513-140138
+* IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 */
 
 using System.Collections.Generic;
@@ -43,7 +43,7 @@ public partial class AssistantService : BaseService
         /// <summary>
         /// Gets and sets the version of the service.
         /// Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is
-        /// `2020-04-01`.
+        /// `2021-06-14`.
         /// </summary>
         public string Version
         {
@@ -68,30 +68,30 @@ public bool DisableSslVerification
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-04-01`.</param>
+        /// The current version is `2021-06-14`.</param>
         public AssistantService(string version) : this(version, defaultServiceName, ConfigBasedAuthenticatorFactory.GetAuthenticator(defaultServiceName)) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-04-01`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="authenticator">The service authenticator.</param>
         public AssistantService(string version, Authenticator authenticator) : this(version, defaultServiceName, authenticator) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-04-01`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="serviceName">The service name to be used when configuring the client instance</param>
         public AssistantService(string version, string serviceName) : this(version, serviceName, ConfigBasedAuthenticatorFactory.GetAuthenticator(serviceName)) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-04-01`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="serviceName">The service name to be used when configuring the client instance</param>
         /// <param name="authenticator">The service authenticator.</param>
         public AssistantService(string version, string serviceName, Authenticator authenticator) : base(authenticator, serviceName)
@@ -4605,8 +4605,8 @@ private void OnListLogsResponse(RESTConnector.Request req, RESTConnector.Respons
         /// <param name="callback">The callback function that is invoked when the operation completes.</param>
         /// <param name="filter">A cacheable parameter that limits the results to those matching the specified filter.
         /// You must specify a filter query that includes a value for `language`, as well as a value for
-        /// `request.context.system.assistant_id`, `workspace_id`, or `request.context.metadata.deployment`. For more
-        /// information, see the
+        /// `request.context.system.assistant_id`, `workspace_id`, or `request.context.metadata.deployment`. These
+        /// required filters must be specified using the exact match (`::`) operator. For more information, see the
         /// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-filter-reference#filter-reference).</param>
         /// <param name="sort">How to sort the returned log events. You can sort by **request_timestamp**. To reverse
         /// the sort order, prefix the parameter value with a minus sign (`-`). (optional)</param>

Scripts/Services/Assistant/V1/Model/RuntimeEntity.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -47,7 +47,10 @@ public class RuntimeEntity
         [JsonProperty("confidence", NullValueHandling = NullValueHandling.Ignore)]
         public float? Confidence { get; set; }
         /// <summary>
-        /// Any metadata for the entity.
+        /// **Deprecated.** Any metadata for the entity.
+        ///
+        /// Beginning with the `2021-06-14` API version, the `metadata` property is no longer returned. For information
+        /// about system entities recognized in the user input, see the `interpretation` property.
         /// </summary>
         [JsonProperty("metadata", NullValueHandling = NullValueHandling.Ignore)]
         public Dictionary<string, object> Metadata { get; set; }

Scripts/Services/Assistant/V2/AssistantService.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2019, 2021.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -16,7 +16,7 @@
 */
 
 /**
-* IBM OpenAPI SDK Code Generator Version: 99-SNAPSHOT-902c9336-20210513-140138
+* IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 */
 
 using System.Collections.Generic;
@@ -43,7 +43,7 @@ public partial class AssistantService : BaseService
         /// <summary>
         /// Gets and sets the version of the service.
         /// Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is
-        /// `2020-09-24`.
+        /// `2021-06-14`.
         /// </summary>
         public string Version
         {
@@ -68,30 +68,30 @@ public bool DisableSslVerification
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-09-24`.</param>
+        /// The current version is `2021-06-14`.</param>
         public AssistantService(string version) : this(version, defaultServiceName, ConfigBasedAuthenticatorFactory.GetAuthenticator(defaultServiceName)) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-09-24`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="authenticator">The service authenticator.</param>
         public AssistantService(string version, Authenticator authenticator) : this(version, defaultServiceName, authenticator) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-09-24`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="serviceName">The service name to be used when configuring the client instance</param>
         public AssistantService(string version, string serviceName) : this(version, serviceName, ConfigBasedAuthenticatorFactory.GetAuthenticator(serviceName)) {}
 
         /// <summary>
         /// AssistantService constructor.
         /// </summary>
         /// <param name="version">Release date of the API version you want to use. Specify dates in YYYY-MM-DD format.
-        /// The current version is `2020-09-24`.</param>
+        /// The current version is `2021-06-14`.</param>
         /// <param name="serviceName">The service name to be used when configuring the client instance</param>
         /// <param name="authenticator">The service authenticator.</param>
         public AssistantService(string version, string serviceName, Authenticator authenticator) : base(authenticator, serviceName)

Scripts/Services/Assistant/V2/Model/RuntimeEntity.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -47,7 +47,10 @@ public class RuntimeEntity
         [JsonProperty("confidence", NullValueHandling = NullValueHandling.Ignore)]
         public float? Confidence { get; set; }
         /// <summary>
-        /// Any metadata for the entity.
+        /// **Deprecated.** Any metadata for the entity.
+        ///
+        /// Beginning with the `2021-06-14` API version, the `metadata` property is no longer returned. For information
+        /// about system entities recognized in the user input, see the `interpretation` property.
         /// </summary>
         [JsonProperty("metadata", NullValueHandling = NullValueHandling.Ignore)]
         public Dictionary<string, object> Metadata { get; set; }

Scripts/Services/Discovery/V1/DiscoveryService.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2019, 2020.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -16,7 +16,7 @@
 */
 
 /**
-* IBM OpenAPI SDK Code Generator Version: 99-SNAPSHOT-a45d89ef-20201209-153452
+* IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 */
 
 using System.Collections.Generic;
@@ -2725,7 +2725,7 @@ private void OnDeleteDocumentResponse(RESTConnector.Request req, RESTConnector.R
         /// are biased towards higher field values. This parameter cannot be used in the same query as the **sort**
         /// parameter. (optional)</param>
         /// <param name="spellingSuggestions">When `true` and the **natural_language_query** parameter is used, the
-        /// **natural_languge_query** parameter is spell checked. The most likely correction is retunred in the
+        /// **natural_languge_query** parameter is spell checked. The most likely correction is returned in the
         /// **suggested_query** field of the response (if one exists).
         ///
         /// **Important:** this parameter is only valid when using the Cloud Pak version of Discovery. (optional,
@@ -3406,7 +3406,7 @@ private void OnFederatedQueryNoticesResponse(RESTConnector.Request req, RESTConn
         /// <param name="environmentId">The ID of the environment.</param>
         /// <param name="collectionId">The ID of the collection.</param>
         /// <param name="prefix">The prefix to use for autocompletion. For example, the prefix `Ho` could autocomplete
-        /// to `Hot`, `Housing`, or `How do I upgrade`. Possible completions are.</param>
+        /// to `hot`, `housing`, or `how`.</param>
         /// <param name="field">The field in the result documents that autocompletion suggestions are identified from.
         /// (optional)</param>
         /// <param name="count">The number of autocompletion suggestions to return. (optional)</param>

Scripts/Services/Discovery/V1/Model/Calculation.cs

@@ -1,5 +1,5 @@
 /**
-* Copyright 2018, 2019 IBM Corp. All Rights Reserved.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -23,7 +23,7 @@ namespace IBM.Watson.Discovery.V1.Model
     /// <summary>
     /// Calculation.
     /// </summary>
-    public class Calculation: QueryAggregation
+    public class Calculation : QueryAggregation
     {
         /// <summary>
         /// The field where the aggregation is located in the document.

Scripts/Services/Discovery/V1/Model/Enrichment.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2018, 2020.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -56,9 +56,9 @@ public class Enrichment
         ///  When using `natual_language_understanding`, the **options** object must contain Natural Language
         /// Understanding options.
         ///
-        ///  When using `elements` the **options** object must contain Element Classification options. Additionally,
-        /// when using the `elements` enrichment the configuration specified and files ingested must meet all the
-        /// criteria specified in [the
+        /// When using `elements` the **options** object must contain Element Classification options. Additionally, when
+        /// using the `elements` enrichment the configuration specified and files ingested must meet all the criteria
+        /// specified in [the
         /// documentation](https://cloud.ibm.com/docs/discovery?topic=discovery-element-classification#element-classification).
         /// </summary>
         [JsonProperty("enrichment", NullValueHandling = NullValueHandling.Ignore)]

Scripts/Services/Discovery/V1/Model/EnrichmentOptions.cs

@@ -1,5 +1,5 @@
 /**
-* Copyright 2018, 2019 IBM Corp. All Rights Reserved.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -86,7 +86,7 @@ public class LanguageValue
         [JsonProperty("features", NullValueHandling = NullValueHandling.Ignore)]
         public NluEnrichmentFeatures Features { get; set; }
         /// <summary>
-        /// *For use with `elements` enrichments only.* The element extraction model to use. Models available are:
+        /// For use with `elements` enrichments only. The element extraction model to use. The only model available is
         /// `contract`.
         /// </summary>
         [JsonProperty("model", NullValueHandling = NullValueHandling.Ignore)]

Scripts/Services/Discovery/V1/Model/Filter.cs

@@ -1,5 +1,5 @@
 /**
-* Copyright 2018, 2019 IBM Corp. All Rights Reserved.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -23,7 +23,7 @@ namespace IBM.Watson.Discovery.V1.Model
     /// <summary>
     /// Filter.
     /// </summary>
-    public class Filter: QueryAggregation
+    public class Filter : QueryAggregation
     {
         /// <summary>
         /// The match the aggregated results queried for.

Scripts/Services/Discovery/V1/Model/Histogram.cs

@@ -1,5 +1,5 @@
 /**
-* Copyright 2018, 2019 IBM Corp. All Rights Reserved.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -23,7 +23,7 @@ namespace IBM.Watson.Discovery.V1.Model
     /// <summary>
     /// Histogram.
     /// </summary>
-    public class Histogram: QueryAggregation
+    public class Histogram : QueryAggregation
     {
         /// <summary>
         /// The field where the aggregation is located in the document.

Scripts/Services/Discovery/V1/Model/Nested.cs

@@ -1,5 +1,5 @@
 /**
-* Copyright 2018, 2019 IBM Corp. All Rights Reserved.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -23,7 +23,7 @@ namespace IBM.Watson.Discovery.V1.Model
     /// <summary>
     /// Nested.
     /// </summary>
-    public class Nested: QueryAggregation
+    public class Nested : QueryAggregation
     {
         /// <summary>
         /// The area of the results the aggregation was restricted to.

Scripts/Services/Discovery/V1/Model/Notice.cs

@@ -1,5 +1,5 @@
 /**
-* Copyright 2018, 2019 IBM Corp. All Rights Reserved.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -55,7 +55,7 @@ public class SeverityValue
         /// `missing_model`, `unsupported_model`, `smart_document_understanding_failed_incompatible_field`,
         /// `smart_document_understanding_failed_internal_error`, `smart_document_understanding_failed_internal_error`,
         /// `smart_document_understanding_failed_warning`, `smart_document_understanding_page_error`,
-        /// `smart_document_understanding_page_warning`. **Note:** This is not a complete list, other values might be
+        /// `smart_document_understanding_page_warning`. **Note:** This is not a complete list; other values might be
         /// returned.
         /// </summary>
         [JsonProperty("notice_id", NullValueHandling = NullValueHandling.Ignore)]
@@ -76,8 +76,8 @@ public class SeverityValue
         [JsonProperty("query_id", NullValueHandling = NullValueHandling.Ignore)]
         public virtual string QueryId { get; private set; }
         /// <summary>
-        /// Ingestion or training step in which the notice occurred. Typical step values include: `classify_elements`,
-        /// `smartDocumentUnderstanding`, `ingestion`, `indexing`, `convert`. **Note:** This is not a complete list,
+        /// Ingestion or training step in which the notice occurred. Typical step values include:
+        /// `smartDocumentUnderstanding`, `ingestion`, `indexing`, `convert`. **Note:** This is not a complete list;
         /// other values might be returned.
         /// </summary>
         [JsonProperty("step", NullValueHandling = NullValueHandling.Ignore)]

Scripts/Services/Discovery/V1/Model/QueryNoticesResult.cs

@@ -1,5 +1,5 @@
 /**
-* Copyright 2018, 2019 IBM Corp. All Rights Reserved.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -24,7 +24,7 @@ namespace IBM.Watson.Discovery.V1.Model
     /// <summary>
     /// Query result object.
     /// </summary>
-    public class QueryNoticesResult: DynamicModel<object>
+    public class QueryNoticesResult : DynamicModel<object>
     {
         /// <summary>
         /// The type of the original source file.

Scripts/Services/Discovery/V1/Model/QueryResult.cs

@@ -1,5 +1,5 @@
 /**
-* Copyright 2018, 2019 IBM Corp. All Rights Reserved.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -24,7 +24,7 @@ namespace IBM.Watson.Discovery.V1.Model
     /// <summary>
     /// Query result object.
     /// </summary>
-    public class QueryResult: DynamicModel<object>
+    public class QueryResult : DynamicModel<object>
     {
         /// <summary>
         /// The unique identifier of the document.

Scripts/Services/Discovery/V1/Model/Term.cs

@@ -1,5 +1,5 @@
 /**
-* Copyright 2018, 2019 IBM Corp. All Rights Reserved.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -23,7 +23,7 @@ namespace IBM.Watson.Discovery.V1.Model
     /// <summary>
     /// Term.
     /// </summary>
-    public class Term: QueryAggregation
+    public class Term : QueryAggregation
     {
         /// <summary>
         /// The field where the aggregation is located in the document.

Scripts/Services/Discovery/V1/Model/Timeslice.cs

@@ -1,5 +1,5 @@
 /**
-* Copyright 2018, 2019 IBM Corp. All Rights Reserved.
+* (C) Copyright IBM Corp. 2021.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -23,7 +23,7 @@ namespace IBM.Watson.Discovery.V1.Model
     /// <summary>
     /// Timeslice.
     /// </summary>
-    public class Timeslice: QueryAggregation
+    public class Timeslice : QueryAggregation
     {
         /// <summary>
         /// The field where the aggregation is located in the document.