meta(crons): Update API help text (#58048)

Updates API help text for Crons validators

src/sentry/monitors/validators.py

@@ -230,21 +230,26 @@ def validate(self, attrs):
  return attrs
 
 
-@extend_schema_serializer(exclude_fields=["project", "name", "slug", "config", "alert_rule"])
+@extend_schema_serializer(exclude_fields=["project", "config", "alert_rule"])
 class MonitorValidator(CamelSnakeSerializer, PreventNumericSlugMixin):
  project = ProjectField(scope="project:read")
- name = serializers.CharField(max_length=128)
+ name = serializers.CharField(
+ max_length=128,
+ help_text="Name of the monitor. Used for notifications.",
+ )
  slug = serializers.RegexField(
  DEFAULT_SLUG_PATTERN,
  max_length=MAX_SLUG_LENGTH,
  required=False,
  error_messages={
  "invalid": DEFAULT_SLUG_ERROR_MESSAGE,
  },
+ help_text="Uniquely identifies your monitor within your organization. Changing this slug will require updates to any instrumented check-in calls.",
  )
  status = serializers.ChoiceField(
  choices=list(zip(MONITOR_STATUSES.keys(), MONITOR_STATUSES.keys())),
  default="active",
+ help_text="Status of the monitor. Disabled monitors do not generate events or notifications.",
  )
  type = serializers.ChoiceField(choices=list(zip(MONITOR_TYPES.keys(), MONITOR_TYPES.keys())))
  config = ConfigValidator()
@@ -288,22 +293,28 @@ class ContextsValidator(serializers.Serializer):
  trace = TraceContextValidator(required=False)
 
 
-@extend_schema_serializer(exclude_fields=["duration", "environment", "monitor_config", "contexts"])
+@extend_schema_serializer(exclude_fields=["monitor_config", "contexts"])
 class MonitorCheckInValidator(serializers.Serializer):
  status = serializers.ChoiceField(
  choices=(
  ("ok", CheckInStatus.OK),
  ("error", CheckInStatus.ERROR),
  ("in_progress", CheckInStatus.IN_PROGRESS),
- )
+ ),
+ help_text="The status of the job run.",
  )
  duration = EmptyIntegerField(
  required=False,
  allow_null=True,
  max_value=BoundedPositiveIntegerField.MAX_VALUE,
  min_value=0,
+ help_text="Duration of the job run, in milliseconds.",
+ )
+ environment = serializers.CharField(
+ required=False,
+ allow_null=True,
+ help_text="Name of the environment.",
  )
- environment = serializers.CharField(required=False, allow_null=True)
  monitor_config = ConfigValidator(required=False)
  contexts = ContextsValidator(required=False, allow_null=True)