docs: improved comment clarity

Google APIs · copybara-github · commit 984bf3328ad9 · 2025-03-11T12:10:44.000-07:00
PiperOrigin-RevId: 735843146
diff --git a/google/api/cloudquotas/v1beta/quota_adjuster_settings.proto b/google/api/cloudquotas/v1beta/quota_adjuster_settings.proto
@@ -65,8 +65,8 @@ service QuotaAdjusterSettingsManager {
 
 // Request for getting QuotaAdjusterSettings
 message GetQuotaAdjusterSettingsRequest {
-  // Required. Name of the config. Required to be “settings”, as only a single
-  // setting per container will be supported initially.
+  // Required. Name of the `quotaAdjusterSettings` configuration. Only a single
+  // setting per project is supported.
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -85,9 +85,9 @@ message UpdateQuotaAdjusterSettingsRequest {
   google.protobuf.FieldMask update_mask = 2
       [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. If set to true, validate the request, but do not actually update.
-  // Note that a request being valid does not mean that the request is
-  // guaranteed to be fulfilled.
+  // Optional. If set to true, checks the syntax of the request but doesn't
+  // update the quota adjuster settings value. Note that although a request can
+  // be valid, that doesn't guarantee that the request will be fulfilled.
   bool validate_only = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -114,21 +114,22 @@ message QuotaAdjusterSettings {
     DISABLED = 3;
   }
 
-  // Identifier. Name of the config would be of the format:
-  //   projects/12345/locations/global/quotaAdjusterSettings
+  // Identifier. Name of the configuration, in the following format:
+  //   `projects/PROJECT_NUMBER/locations/global/quotaAdjusterSettings`.
+  // Replace PROJECT_NUMBER with the project number for your project.
   string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // Required. The configured value of the enablement at the given resource.
   Enablement enablement = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Output only. The timestamp when the QuotaAdjusterSettings was last updated.
+  // Output only. The timestamp when the QuotaAdjusterSettings resource was last
+  // updated.
   google.protobuf.Timestamp update_time = 5
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Optional. The current etag of the QuotaAdjusterSettings. If an etag is
-  // provided on update and does not match the current server's etag of the
-  // QuotaAdjusterSettings, the request will be blocked and an ABORTED error
-  // will be returned. See https://google.aip.dev/134#etags for more details on
-  // etags.
+  // Optional. The current ETag of the QuotaAdjusterSettings. If an ETag is
+  // provided on update and does not match the current server's ETag in the
+  // QuotaAdjusterSettings, the request is blocked and returns an ABORTED error.
+  // See https://google.aip.dev/134#etags for more details on ETags.
   string etag = 6 [(google.api.field_behavior) = OPTIONAL];
 }
