Improve oncall schedule endpoint documentation (#2744)

Co-authored-by: ci.datadog-api-spec <[email protected]>

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:

services/on_call/src/v2/models/Shift.ts

@@ -4,11 +4,11 @@ import { ShiftData } from "./ShiftData";
 import { ShiftIncluded } from "./ShiftIncluded";
 
 /**
- * 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;
   /**

services/on_call/src/v2/models/ShiftData.ts

@@ -5,19 +5,19 @@ import { ShiftDataRelationships } from "./ShiftDataRelationships";
 import { ShiftDataType } from "./ShiftDataType";
 
 /**
- * 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;
   /**

services/on_call/src/v2/models/ShiftDataAttributes.ts

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

services/on_call/src/v2/models/ShiftDataRelationships.ts

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

services/on_call/src/v2/models/ShiftIncluded.ts

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