Improve oncall schedule endpoint documentation (#2644)

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:

lib/datadog_api_client/v2/models/shift.rb

@@ -17,11 +17,11 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # The definition of `Shift` object.
+  # An on-call shift with its associated data and relationships.
   class Shift
     include BaseGenericModel
 
-    # The definition of `ShiftData` object.
+    # Data for an on-call shift.
     attr_accessor :data
 
     # The `Shift` `included`.

lib/datadog_api_client/v2/models/shift_data.rb

@@ -17,17 +17,17 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # The definition of `ShiftData` object.
+  # Data for an on-call shift.
   class ShiftData
     include BaseGenericModel
 
-    # The definition of `ShiftDataAttributes` object.
+    # Attributes for an on-call shift.
     attr_accessor :attributes
 
     # The `ShiftData` `id`.
     attr_accessor :id
 
-    # The definition of `ShiftDataRelationships` object.
+    # Relationships for an on-call shift.
     attr_accessor :relationships
 
     # Indicates that the resource is of type 'shifts'.

lib/datadog_api_client/v2/models/shift_data_attributes.rb

@@ -17,7 +17,7 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # The definition of `ShiftDataAttributes` object.
+  # Attributes for an on-call shift.
   class ShiftDataAttributes
     include BaseGenericModel
 

lib/datadog_api_client/v2/models/shift_data_relationships.rb

@@ -17,7 +17,7 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # The definition of `ShiftDataRelationships` object.
+  # Relationships for an on-call shift.
   class ShiftDataRelationships
     include BaseGenericModel
 

lib/datadog_api_client/v2/models/shift_included.rb

@@ -17,7 +17,7 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # The definition of `ShiftIncluded` object.
+  # Included data for shift operations.
   module ShiftIncluded
     class << self
       include BaseOneOfModel