chore(spec): add missing descriptions to OpenAPI schemas and properties [all] (#3747)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -2,7 +2,13 @@ import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 import { ServiceListData } from "./ServiceListData";
 
+/**
+ * The response body for the service list endpoint.
+ */
 export class ServiceList {
+  /**
+   * A single data item in the service list response.
+   */
   "data"?: ServiceListData;
   /**
    * A container for additional, undeclared properties.

services/apm/src/v2/models/ServiceList.ts

@@ -3,8 +3,17 @@ import { AttributeTypeMap } from "@datadog/datadog-api-client";
 import { ServiceListDataAttributes } from "./ServiceListDataAttributes";
 import { ServiceListDataType } from "./ServiceListDataType";
 
+/**
+ * A single data item in the service list response.
+ */
 export class ServiceListData {
+  /**
+   * Attributes of a service list entry, containing metadata and a list of service names.
+   */
   "attributes"?: ServiceListDataAttributes;
+  /**
+   * The unique identifier of the service.
+   */
   "id"?: string;
   /**
    * Services list resource type.

services/apm/src/v2/models/ServiceListData.ts

@@ -2,8 +2,17 @@ import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 import { ServiceListDataAttributesMetadataItems } from "./ServiceListDataAttributesMetadataItems";
 
+/**
+ * Attributes of a service list entry, containing metadata and a list of service names.
+ */
 export class ServiceListDataAttributes {
+  /**
+   * A list of metadata items associated with the service.
+   */
   "metadata"?: Array<ServiceListDataAttributesMetadataItems>;
+  /**
+   * A list of service names.
+   */
   "services"?: Array<string>;
   /**
    * A container for additional, undeclared properties.

services/apm/src/v2/models/ServiceListDataAttributes.ts

@@ -1,7 +1,16 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
+/**
+ * An object containing metadata flags for a service, indicating whether it is traced by APM or monitored through Universal Service Monitoring.
+ */
 export class ServiceListDataAttributesMetadataItems {
+  /**
+   * Indicates whether the service is traced by APM.
+   */
   "isTraced"?: boolean;
+  /**
+   * Indicates whether the service uses Universal Service Monitoring.
+   */
   "isUsm"?: boolean;
   /**
    * A container for additional, undeclared properties.

services/apm/src/v2/models/ServiceListDataAttributesMetadataItems.ts

@@ -4030,7 +4030,7 @@ export interface CaseManagementApiCreateCaseServiceNowTicketRequest {
 
 export interface CaseManagementApiCreateProjectRequest {
   /**
-   * Project payload
+   * Project payload.
    * @type ProjectCreateRequest
    */
   body: ProjectCreateRequest;
@@ -4077,7 +4077,7 @@ export interface CaseManagementApiDeleteCaseCustomAttributeRequest {
 
 export interface CaseManagementApiDeleteProjectRequest {
   /**
-   * Project UUID
+   * Project UUID.
    * @type string
    */
   projectId: string;
@@ -4106,7 +4106,7 @@ export interface CaseManagementApiGetCaseRequest {
 
 export interface CaseManagementApiGetProjectRequest {
   /**
-   * Project UUID
+   * Project UUID.
    * @type string
    */
   projectId: string;
@@ -4293,12 +4293,12 @@ export interface CaseManagementApiUpdatePriorityRequest {
 
 export interface CaseManagementApiUpdateProjectRequest {
   /**
-   * Project UUID
+   * Project UUID.
    * @type string
    */
   projectId: string;
   /**
-   * Project payload
+   * Project payload.
    * @type ProjectUpdateRequest
    */
   body: ProjectUpdateRequest;

services/case_management/src/v2/CaseManagementApi.ts

@@ -1,5 +1,8 @@
 import { UnparsedObject } from "@datadog/datadog-api-client";
 
+/**
+ * A single item in an array of arbitrary values, which can be a string, number, object, or boolean.
+ */
 export type AnyValueItem =
   | string
   | number

services/case_management/src/v2/models/AnyValueItem.ts

@@ -1,15 +1,15 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 /**
- * Auto-close inactive cases settings
+ * Auto-close inactive cases settings.
  */
 export class AutoCloseInactiveCases {
   /**
-   * Whether auto-close is enabled
+   * Whether auto-close is enabled.
    */
   "enabled"?: boolean;
   /**
-   * Maximum inactive time in seconds before auto-closing
+   * Maximum inactive time in seconds before auto-closing.
    */
   "maxInactiveTimeInSecs"?: number;
   /**

services/case_management/src/v2/models/AutoCloseInactiveCases.ts

@@ -1,11 +1,11 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 /**
- * Auto-transition assigned cases settings
+ * Auto-transition assigned cases settings.
  */
 export class AutoTransitionAssignedCases {
   /**
-   * Whether to auto-transition cases when self-assigned
+   * Whether to auto-transition cases when self-assigned.
    */
   "autoTransitionAssignedCasesOnSelfAssigned"?: boolean;
   /**

services/case_management/src/v2/models/AutoTransitionAssignedCases.ts

@@ -12,7 +12,7 @@ export class CaseCreateRelationships {
    */
   "assignee"?: NullableUserRelationship;
   /**
-   * Relationship to project
+   * Relationship to project.
    */
   "project": ProjectRelationship;
   /**