Improve oncall schedule endpoint documentation (#2745)

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

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

.generator/schemas/v2/openapi.yaml

@@ -41720,7 +41720,7 @@ components:
           type: string
       type: object
     Shift:
-      description: The definition of `Shift` object.
+      description: An on-call shift with its associated data and relationships.
       example:
         data:
           attributes:
@@ -41751,7 +41751,7 @@ components:
           type: array
       type: object
     ShiftData:
-      description: The definition of `ShiftData` object.
+      description: Data for an on-call shift.
       properties:
         attributes:
           $ref: '#/components/schemas/ShiftDataAttributes'
@@ -41766,7 +41766,7 @@ components:
       - type
       type: object
     ShiftDataAttributes:
-      description: The definition of `ShiftDataAttributes` object.
+      description: Attributes for an on-call shift.
       properties:
         end:
           description: The end time of the shift.
@@ -41778,7 +41778,7 @@ components:
           type: string
       type: object
     ShiftDataRelationships:
-      description: The definition of `ShiftDataRelationships` object.
+      description: Relationships for an on-call shift.
       properties:
         user:
           $ref: '#/components/schemas/ShiftDataRelationshipsUser'
@@ -41825,7 +41825,7 @@ components:
       x-enum-varnames:
       - SHIFTS
     ShiftIncluded:
-      description: The definition of `ShiftIncluded` object.
+      description: Included data for shift operations.
       oneOf:
       - $ref: '#/components/schemas/ScheduleUser'
     SimpleMonitorUserTemplate:

packages/datadog-api-client-v2/models/Shift.ts

@@ -9,11 +9,11 @@ import { ShiftIncluded } from "./ShiftIncluded";
 import { AttributeTypeMap } from "../../datadog-api-client-common/util";
 
 /**
- * The definition of `Shift` object.
+ * An on-call shift with its associated data and relationships.
  */
 export class Shift {
   /**
-   * The definition of `ShiftData` object.
+   * Data for an on-call shift.
    */
   "data"?: ShiftData;
   /**

packages/datadog-api-client-v2/models/ShiftData.ts

@@ -10,19 +10,19 @@ import { ShiftDataType } from "./ShiftDataType";
 import { AttributeTypeMap } from "../../datadog-api-client-common/util";
 
 /**
- * The definition of `ShiftData` object.
+ * Data for an on-call shift.
  */
 export class ShiftData {
   /**
-   * The definition of `ShiftDataAttributes` object.
+   * Attributes for an on-call shift.
    */
   "attributes"?: ShiftDataAttributes;
   /**
    * The `ShiftData` `id`.
    */
   "id"?: string;
   /**
-   * The definition of `ShiftDataRelationships` object.
+   * Relationships for an on-call shift.
    */
   "relationships"?: ShiftDataRelationships;
   /**

packages/datadog-api-client-v2/models/ShiftDataAttributes.ts

@@ -7,7 +7,7 @@
 import { AttributeTypeMap } from "../../datadog-api-client-common/util";
 
 /**
- * The definition of `ShiftDataAttributes` object.
+ * Attributes for an on-call shift.
  */
 export class ShiftDataAttributes {
   /**

packages/datadog-api-client-v2/models/ShiftDataRelationships.ts

@@ -8,7 +8,7 @@ import { ShiftDataRelationshipsUser } from "./ShiftDataRelationshipsUser";
 import { AttributeTypeMap } from "../../datadog-api-client-common/util";
 
 /**
- * The definition of `ShiftDataRelationships` object.
+ * Relationships for an on-call shift.
  */
 export class ShiftDataRelationships {
   /**

packages/datadog-api-client-v2/models/ShiftIncluded.ts

@@ -8,7 +8,7 @@ import { ScheduleUser } from "./ScheduleUser";
 import { UnparsedObject } from "../../datadog-api-client-common/util";
 
 /**
- * The definition of `ShiftIncluded` object.
+ * Included data for shift operations.
  */
 
 export type ShiftIncluded = ScheduleUser | UnparsedObject;