Improve oncall schedule endpoint documentation (#2812)

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:

src/datadog_api_client/v2/model/shift.py

@@ -42,9 +42,9 @@ def __init__(
         **kwargs,
     ):
         """
-        The definition of ``Shift`` object.
+        An on-call shift with its associated data and relationships.
 
-        :param data: The definition of ``ShiftData`` object.
+        :param data: Data for an on-call shift.
         :type data: ShiftData, optional
 
         :param included: The ``Shift`` ``included``.

src/datadog_api_client/v2/model/shift_data.py

@@ -49,15 +49,15 @@ def __init__(
         **kwargs,
     ):
         """
-        The definition of ``ShiftData`` object.
+        Data for an on-call shift.
 
-        :param attributes: The definition of ``ShiftDataAttributes`` object.
+        :param attributes: Attributes for an on-call shift.
         :type attributes: ShiftDataAttributes, optional
 
         :param id: The ``ShiftData`` ``id``.
         :type id: str, optional
 
-        :param relationships: The definition of ``ShiftDataRelationships`` object.
+        :param relationships: Relationships for an on-call shift.
         :type relationships: ShiftDataRelationships, optional
 
         :param type: Indicates that the resource is of type 'shifts'.

src/datadog_api_client/v2/model/shift_data_attributes.py

@@ -29,7 +29,7 @@ def openapi_types(_):
 
     def __init__(self_, end: Union[datetime, UnsetType] = unset, start: Union[datetime, UnsetType] = unset, **kwargs):
         """
-        The definition of ``ShiftDataAttributes`` object.
+        Attributes for an on-call shift.
 
         :param end: The end time of the shift.
         :type end: datetime, optional

src/datadog_api_client/v2/model/shift_data_relationships.py

@@ -32,7 +32,7 @@ def openapi_types(_):
 
     def __init__(self_, user: Union[ShiftDataRelationshipsUser, UnsetType] = unset, **kwargs):
         """
-        The definition of ``ShiftDataRelationships`` object.
+        Relationships for an on-call shift.
 
         :param user: Defines the relationship between a shift and the user who is working that shift.
         :type user: ShiftDataRelationshipsUser, optional

src/datadog_api_client/v2/model/shift_included.py

@@ -13,7 +13,7 @@
 class ShiftIncluded(ModelComposed):
     def __init__(self, **kwargs):
         """
-        The definition of ``ShiftIncluded`` object.
+        Included data for shift operations.
 
         :param attributes: Provides basic user information for a schedule, including a name and email address.
         :type attributes: ScheduleUserAttributes, optional