Improve oncall schedule endpoint documentation (#3324)

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:

api/datadogV2/model_shift.go

@@ -8,9 +8,9 @@ import (
 	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
 )
 
-// Shift The definition of `Shift` object.
+// Shift An on-call shift with its associated data and relationships.
 type Shift struct {
-	// The definition of `ShiftData` object.
+	// Data for an on-call shift.
 	Data *ShiftData `json:"data,omitempty"`
 	// The `Shift` `included`.
 	Included []ShiftIncluded `json:"included,omitempty"`

api/datadogV2/model_shift_data.go

@@ -10,13 +10,13 @@ import (
 	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
 )
 
-// ShiftData The definition of `ShiftData` object.
+// ShiftData Data for an on-call shift.
 type ShiftData struct {
-	// The definition of `ShiftDataAttributes` object.
+	// Attributes for an on-call shift.
 	Attributes *ShiftDataAttributes `json:"attributes,omitempty"`
 	// The `ShiftData` `id`.
 	Id *string `json:"id,omitempty"`
-	// The definition of `ShiftDataRelationships` object.
+	// Relationships for an on-call shift.
 	Relationships *ShiftDataRelationships `json:"relationships,omitempty"`
 	// Indicates that the resource is of type 'shifts'.
 	Type ShiftDataType `json:"type"`

api/datadogV2/model_shift_data_attributes.go

@@ -10,7 +10,7 @@ import (
 	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
 )
 
-// ShiftDataAttributes The definition of `ShiftDataAttributes` object.
+// ShiftDataAttributes Attributes for an on-call shift.
 type ShiftDataAttributes struct {
 	// The end time of the shift.
 	End *time.Time `json:"end,omitempty"`

api/datadogV2/model_shift_data_relationships.go

@@ -8,7 +8,7 @@ import (
 	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
 )
 
-// ShiftDataRelationships The definition of `ShiftDataRelationships` object.
+// ShiftDataRelationships Relationships for an on-call shift.
 type ShiftDataRelationships struct {
 	// Defines the relationship between a shift and the user who is working that shift.
 	User *ShiftDataRelationshipsUser `json:"user,omitempty"`

api/datadogV2/model_shift_included.go

@@ -8,7 +8,7 @@ import (
 	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
 )
 
-// ShiftIncluded - The definition of `ShiftIncluded` object.
+// ShiftIncluded - Included data for shift operations.
 type ShiftIncluded struct {
 	ScheduleUser *ScheduleUser