docs: Add missing comments for messages

Google APIs · copybara-github · commit 9510a3a5c293 · 2025-07-08T02:03:28.000-07:00
PiperOrigin-RevId: 780467630
diff --git a/google/cloud/maintenance/api/v1beta/maintenance_service.proto b/google/cloud/maintenance/api/v1beta/maintenance_service.proto
@@ -70,6 +70,7 @@ message SummarizeMaintenancesRequest {
   string order_by = 10508;
 }
 
+// Request message for SummarizeMaintenances custom method.
 message SummarizeMaintenancesResponse {
   // The resulting summaries.
   repeated MaintenanceSummary maintenances = 10509;
@@ -87,6 +88,7 @@ message SummarizeMaintenancesResponse {
 // MaintenanceSummary contains maintenance statistics calculated based on
 // ResourceMaintenances within the scope: project and location.
 message MaintenanceSummary {
+  // Stats indicates the type of aggregate and the corresponding aggregates.
   message Stats {
     // groupBy specifies the type of aggregate.
     // For example a group_by might be `"state"`
@@ -98,6 +100,7 @@ message MaintenanceSummary {
     repeated Aggregate aggregates = 2;
   }
 
+  // Aggregate is a <group, count> pair.
   message Aggregate {
     // Specifies what specific value of the group_by the count represents. For
     // example if group_by is `"state"` its corresponding group could be
