Improve oncall schedule endpoint documentation (#3109)

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:

src/main/java/com/datadog/api/client/v2/model/Shift.java

@@ -18,7 +18,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** The definition of <code>Shift</code> object. */
+/** An on-call shift with its associated data and relationships. */
 @JsonPropertyOrder({Shift.JSON_PROPERTY_DATA, Shift.JSON_PROPERTY_INCLUDED})
 @jakarta.annotation.Generated(
     value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")
@@ -37,7 +37,7 @@ public Shift data(ShiftData data) {
   }
 
   /**
-   * The definition of <code>ShiftData</code> object.
+   * Data for an on-call shift.
    *
    * @return data
    */

src/main/java/com/datadog/api/client/v2/model/ShiftData.java

@@ -17,7 +17,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** The definition of <code>ShiftData</code> object. */
+/** Data for an on-call shift. */
 @JsonPropertyOrder({
   ShiftData.JSON_PROPERTY_ATTRIBUTES,
   ShiftData.JSON_PROPERTY_ID,
@@ -55,7 +55,7 @@ public ShiftData attributes(ShiftDataAttributes attributes) {
   }
 
   /**
-   * The definition of <code>ShiftDataAttributes</code> object.
+   * Attributes for an on-call shift.
    *
    * @return attributes
    */
@@ -98,7 +98,7 @@ public ShiftData relationships(ShiftDataRelationships relationships) {
   }
 
   /**
-   * The definition of <code>ShiftDataRelationships</code> object.
+   * Relationships for an on-call shift.
    *
    * @return relationships
    */

src/main/java/com/datadog/api/client/v2/model/ShiftDataAttributes.java

@@ -17,7 +17,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** The definition of <code>ShiftDataAttributes</code> object. */
+/** Attributes for an on-call shift. */
 @JsonPropertyOrder({ShiftDataAttributes.JSON_PROPERTY_END, ShiftDataAttributes.JSON_PROPERTY_START})
 @jakarta.annotation.Generated(
     value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")

src/main/java/com/datadog/api/client/v2/model/ShiftDataRelationships.java

@@ -16,7 +16,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** The definition of <code>ShiftDataRelationships</code> object. */
+/** Relationships for an on-call shift. */
 @JsonPropertyOrder({ShiftDataRelationships.JSON_PROPERTY_USER})
 @jakarta.annotation.Generated(
     value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")