Add missing descriptions to v1 spec schemas and properties

.generator/schemas/v1/openapi.yaml

@@ -2782,6 +2782,7 @@ components:
         peer_tags:
           description: Tags to query for a specific downstream entity (peer.service, peer.db_instance, peer.s3, peer.s3.bucket, etc.).
           items:
+            description: "A tag identifying a specific downstream entity (for example: peer.service, peer.db_instance)."
             example: "peer.service:my-service"
             type: string
           type: array
@@ -6647,6 +6648,7 @@ components:
         sources:
           additionalProperties:
             items:
+              description: A fallback source attribute name.
               type: string
             type: array
           description: Fallback sources used to populate value of field.
@@ -6695,6 +6697,7 @@ components:
           description: Optional list of profiles to modify the schema.
           example: ["security_control", "host"]
           items:
+            description: A profile name that modifies the schema behavior.
             type: string
           type: array
         schema_type:
@@ -7808,6 +7811,7 @@ components:
           description: Columns to group results by.
           example: ["col1", "col2"]
           items:
+            description: A column name to group results by.
             type: string
           type: array
         model_type_override:
@@ -7827,6 +7831,7 @@ components:
           description: Optional grouping fields for aggregation.
           example: ["entity_id"]
           items:
+            description: A field name to group results by.
             type: string
           type: array
         measure:
@@ -11161,8 +11166,10 @@ components:
       description: Product Analytics audience account subquery.
       properties:
         name:
+          description: The name of the account subquery.
           type: string
         query:
+          description: The query string for the account subquery.
           type: string
       type: object
     ProductAnalyticsAudienceFilters:
@@ -11173,6 +11180,7 @@ components:
             $ref: "#/components/schemas/ProductAnalyticsAudienceAccountSubquery"
           type: array
         filter_condition:
+          description: An optional filter condition applied to the audience subquery.
           type: string
         segments:
           items:
@@ -11184,26 +11192,33 @@ components:
           type: array
       type: object
     ProductAnalyticsAudienceOccurrenceFilter:
+      description: Filter applied to occurrence counts when building a Product Analytics audience.
       properties:
         operator:
+          description: "The comparison operator used for the occurrence filter (for example: `gt`, `lt`, `eq`)."
           type: string
         value:
+          description: The threshold value to compare occurrence counts against.
           type: string
       type: object
     ProductAnalyticsAudienceSegmentSubquery:
       description: Product Analytics audience segment subquery.
       properties:
         name:
+          description: The name of the segment subquery.
           type: string
         segment_id:
+          description: The unique identifier of the segment.
           type: string
       type: object
     ProductAnalyticsAudienceUserSubquery:
       description: Product Analytics audience user subquery.
       properties:
         name:
+          description: The name of the user subquery.
           type: string
         query:
+          description: The query string for the user subquery.
           type: string
       type: object
     QuerySortOrder:
@@ -11772,6 +11787,7 @@ components:
         - $ref: "#/components/schemas/SLOCountDefinitionWithBadEventsFormula"
     SLOCountDefinitionWithBadEventsFormula:
       additionalProperties: false
+      description: SLO count definition using a bad events formula alongside a good events formula.
       properties:
         bad_events_formula:
           $ref: "#/components/schemas/SLOFormula"
@@ -11798,6 +11814,7 @@ components:
       type: object
     SLOCountDefinitionWithTotalEventsFormula:
       additionalProperties: false
+      description: SLO count definition using a total events formula alongside a good events formula.
       properties:
         good_events_formula:
           $ref: "#/components/schemas/SLOFormula"
@@ -13004,6 +13021,7 @@ components:
           description: Fields to group by.
           example: ["source", "destination"]
           items:
+            description: A field name to group by.
             type: string
           type: array
         limit:
@@ -13626,6 +13644,7 @@ components:
             Always included in service level objective responses (but may be empty).
           example: ["env:prod", "app:core"]
           items:
+            description: A tag associated with the service level objective.
             type: string
           type: array
         created_at:
@@ -13649,6 +13668,7 @@ components:
         env_tags:
           description: Tags with the `env` tag key.
           items:
+            description: A tag with the `env` tag key.
             type: string
           type: array
         groups:
@@ -13693,6 +13713,7 @@ components:
         service_tags:
           description: Tags with the `service` tag key.
           items:
+            description: A tag with the `service` tag key.
             type: string
           type: array
         slo_type:
@@ -13702,6 +13723,7 @@ components:
         team_tags:
           description: Tags with the `team` tag key.
           items:
+            description: A tag with the `team` tag key.
             type: string
           type: array
         thresholds:
@@ -14712,6 +14734,7 @@ components:
           description: The tag values.
           example: ["env"]
           items:
+            description: A tag value string.
             minLength: 1
             type: string
           type: array
@@ -17989,6 +18012,7 @@ components:
         blockedRequestPatterns:
           description: Array of URL patterns to block.
           items:
+            description: A URL pattern to block during the Synthetic test.
             type: string
           type: array
         checkCertificateRevocation:

.generator/schemas/v2/openapi.yaml

@@ -25792,6 +25792,7 @@ components:
           description: Tags associated with the feature flag.
           example: []
           items:
+            description: A tag associated with the feature flag.
             type: string
           type: array
         updated_at:
@@ -25845,6 +25846,7 @@ components:
             - "test-feature-flag"
             - "env-search-term"
           items:
+            description: A query string targeting the environment.
             type: string
           type: array
         is_production:

src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceAccountSubquery.java

@@ -37,7 +37,7 @@ public ProductAnalyticsAudienceAccountSubquery name(String name) {
   }
 
   /**
-   * Getname
+   * The name of the account subquery.
    *
    * @return name
    */
@@ -58,7 +58,7 @@ public ProductAnalyticsAudienceAccountSubquery query(String query) {
   }
 
   /**
-   * Getquery
+   * The query string for the account subquery.
    *
    * @return query
    */

src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceFilters.java

@@ -82,7 +82,7 @@ public ProductAnalyticsAudienceFilters filterCondition(String filterCondition) {
   }
 
   /**
-   * GetfilterCondition
+   * An optional filter condition applied to the audience subquery.
    *
    * @return filterCondition
    */

src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceOccurrenceFilter.java

@@ -16,7 +16,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Filter applied to occurrence counts when building a Product Analytics audience. */
 @JsonPropertyOrder({
   ProductAnalyticsAudienceOccurrenceFilter.JSON_PROPERTY_OPERATOR,
   ProductAnalyticsAudienceOccurrenceFilter.JSON_PROPERTY_VALUE
@@ -37,7 +37,8 @@ public ProductAnalyticsAudienceOccurrenceFilter operator(String operator) {
   }
 
   /**
-   * Getoperator
+   * The comparison operator used for the occurrence filter (for example: <code>gt</code>, <code>lt
+   * </code>, <code>eq</code>).
    *
    * @return operator
    */
@@ -58,7 +59,7 @@ public ProductAnalyticsAudienceOccurrenceFilter value(String value) {
   }
 
   /**
-   * Getvalue
+   * The threshold value to compare occurrence counts against.
    *
    * @return value
    */

src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceSegmentSubquery.java

@@ -37,7 +37,7 @@ public ProductAnalyticsAudienceSegmentSubquery name(String name) {
   }
 
   /**
-   * Getname
+   * The name of the segment subquery.
    *
    * @return name
    */
@@ -58,7 +58,7 @@ public ProductAnalyticsAudienceSegmentSubquery segmentId(String segmentId) {
   }
 
   /**
-   * GetsegmentId
+   * The unique identifier of the segment.
    *
    * @return segmentId
    */

src/main/java/com/datadog/api/client/v1/model/ProductAnalyticsAudienceUserSubquery.java

@@ -37,7 +37,7 @@ public ProductAnalyticsAudienceUserSubquery name(String name) {
   }
 
   /**
-   * Getname
+   * The name of the user subquery.
    *
    * @return name
    */
@@ -58,7 +58,7 @@ public ProductAnalyticsAudienceUserSubquery query(String query) {
   }
 
   /**
-   * Getquery
+   * The query string for the user subquery.
    *
    * @return query
    */

src/main/java/com/datadog/api/client/v1/model/SLOCountDefinitionWithBadEventsFormula.java

@@ -15,7 +15,7 @@
 import java.util.List;
 import java.util.Objects;
 
-/** */
+/** SLO count definition using a bad events formula alongside a good events formula. */
 @JsonPropertyOrder({
   SLOCountDefinitionWithBadEventsFormula.JSON_PROPERTY_BAD_EVENTS_FORMULA,
   SLOCountDefinitionWithBadEventsFormula.JSON_PROPERTY_GOOD_EVENTS_FORMULA,

src/main/java/com/datadog/api/client/v1/model/SLOCountDefinitionWithTotalEventsFormula.java

@@ -15,7 +15,7 @@
 import java.util.List;
 import java.util.Objects;
 
-/** */
+/** SLO count definition using a total events formula alongside a good events formula. */
 @JsonPropertyOrder({
   SLOCountDefinitionWithTotalEventsFormula.JSON_PROPERTY_GOOD_EVENTS_FORMULA,
   SLOCountDefinitionWithTotalEventsFormula.JSON_PROPERTY_QUERIES,

src/main/java/com/datadog/api/client/v1/model/SankeyRumQuery.java

@@ -220,7 +220,7 @@ public SankeyRumQuery occurrences(ProductAnalyticsAudienceOccurrenceFilter occur
   }
 
   /**
-   * Getoccurrences
+   * Filter applied to occurrence counts when building a Product Analytics audience.
    *
    * @return occurrences
    */