Document dashboard quality scores in usage APIs

.generator/schemas/v2/openapi.yaml

@@ -31548,7 +31548,21 @@ components:
           nullable: true
           type: string
         dashboard_quality_score:
-          description: The dashboard quality score, or `null` when no score is available.
+          description: |-
+            The dashboard quality score ranges from 0 to 1, with higher scores indicating stronger signals of quality
+            and usefulness. The value is `null` when no score is available.
+
+            The score considers the following factors:
+
+            - Dashboard and widget naming, including whether the dashboard uses a default or templated name
+            - The number of data widgets, excluding container and text widgets
+            - Confirmed broken queries
+            - Recent activity, based on the last view date or, when no view date is available, the last edit or
+              creation date
+
+            Dashboards linked from monitors do not receive lower scores because of their naming or lack of recent
+            activity. An age-based adjustment helps prevent newly created dashboards from receiving disproportionately
+            low scores. Queries lower the score only when confirmed broken.
           example: 0.85
           format: double
           nullable: true

src/datadogV2/model/model_dashboard_usage_attributes.rs

@@ -21,7 +21,20 @@ pub struct DashboardUsageAttributes {
         with = "::serde_with::rust::double_option"
     )]
     pub created_at: Option<Option<chrono::DateTime<chrono::Utc>>>,
-    /// The dashboard quality score, or `null` when no score is available.
+    /// The dashboard quality score ranges from 0 to 1, with higher scores indicating stronger signals of quality
+    /// and usefulness. The value is `null` when no score is available.
+    ///
+    /// The score considers the following factors:
+    ///
+    /// - Dashboard and widget naming, including whether the dashboard uses a default or templated name
+    /// - The number of data widgets, excluding container and text widgets
+    /// - Confirmed broken queries
+    /// - Recent activity, based on the last view date or, when no view date is available, the last edit or
+    ///   creation date
+    ///
+    /// Dashboards linked from monitors do not receive lower scores because of their naming or lack of recent
+    /// activity. An age-based adjustment helps prevent newly created dashboards from receiving disproportionately
+    /// low scores. Queries lower the score only when confirmed broken.
     #[serde(
         rename = "dashboard_quality_score",
         default,