docs: [rapidmigrationassessment] update comments (#9847)

* docs: update comments

PiperOrigin-RevId: 566408362

Source-Link: googleapis/googleapis@ba75aae

Source-Link: googleapis/googleapis-gen@b6cbff8
Copy-Tag: eyJwIjoiamF2YS1yYXBpZG1pZ3JhdGlvbmFzc2Vzc21lbnQvLk93bEJvdC55YW1sIiwiaCI6ImI2Y2JmZjgzNDJiNjQzODQzZGM4MjU2OGM4MDdlOTY5MDhkMjRjYzUifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

java-rapidmigrationassessment/README.md

@@ -23,7 +23,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.22.0</version>
+      <version>26.23.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-rapidmigrationassessment/java11.html
 [stability-image]: https://img.shields.io/badge/stability-preview-yellow
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-rapidmigrationassessment.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-rapidmigrationassessment/0.6.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-rapidmigrationassessment/0.7.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-rapidmigrationassessment/google-cloud-rapidmigrationassessment/src/main/java/com/google/cloud/rapidmigrationassessment/v1/RapidMigrationAssessmentClient.java

@@ -44,7 +44,7 @@
 
 // AUTO-GENERATED DOCUMENTATION AND CLASS.
 /**
- * Service Description: Rapid Migration Assessment service
+ * Service Description: Service describing handlers for resources.
  *
  * <p>This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
@@ -1091,7 +1091,8 @@ public final UnaryCallable<UpdateCollectorRequest, Operation> updateCollectorCal
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Deletes a single Collector - changes state of collector to "Deleting".
+   * Deletes a single Collector - changes state of collector to "Deleting". Background jobs does
+   * final deletion thorugh producer api.
    *
    * <p>Sample code:
    *
@@ -1120,7 +1121,8 @@ public final OperationFuture<Collector, OperationMetadata> deleteCollectorAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Deletes a single Collector - changes state of collector to "Deleting".
+   * Deletes a single Collector - changes state of collector to "Deleting". Background jobs does
+   * final deletion thorugh producer api.
    *
    * <p>Sample code:
    *
@@ -1147,7 +1149,8 @@ public final OperationFuture<Collector, OperationMetadata> deleteCollectorAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Deletes a single Collector - changes state of collector to "Deleting".
+   * Deletes a single Collector - changes state of collector to "Deleting". Background jobs does
+   * final deletion thorugh producer api.
    *
    * <p>Sample code:
    *
@@ -1178,7 +1181,8 @@ public final OperationFuture<Collector, OperationMetadata> deleteCollectorAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Deletes a single Collector - changes state of collector to "Deleting".
+   * Deletes a single Collector - changes state of collector to "Deleting". Background jobs does
+   * final deletion thorugh producer api.
    *
    * <p>Sample code:
    *
@@ -1209,7 +1213,8 @@ public final OperationFuture<Collector, OperationMetadata> deleteCollectorAsync(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Deletes a single Collector - changes state of collector to "Deleting".
+   * Deletes a single Collector - changes state of collector to "Deleting". Background jobs does
+   * final deletion thorugh producer api.
    *
    * <p>Sample code:
    *

java-rapidmigrationassessment/google-cloud-rapidmigrationassessment/src/main/java/com/google/cloud/rapidmigrationassessment/v1/package-info.java

@@ -21,7 +21,7 @@
  *
  * <p>======================= RapidMigrationAssessmentClient =======================
  *
- * <p>Service Description: Rapid Migration Assessment service
+ * <p>Service Description: Service describing handlers for resources.
  *
  * <p>Sample for RapidMigrationAssessmentClient:
  *

java-rapidmigrationassessment/grpc-google-cloud-rapidmigrationassessment-v1/src/main/java/com/google/cloud/rapidmigrationassessment/v1/RapidMigrationAssessmentGrpc.java

@@ -21,7 +21,7 @@
  *
  *
  * <pre>
- * Rapid Migration Assessment service
+ * Service describing handlers for resources.
  * </pre>
  */
 @javax.annotation.Generated(
@@ -559,7 +559,7 @@ public RapidMigrationAssessmentFutureStub newStub(
    *
    *
    * <pre>
-   * Rapid Migration Assessment service
+   * Service describing handlers for resources.
    * </pre>
    */
   public interface AsyncService {
@@ -658,6 +658,7 @@ default void updateCollector(
      *
      * <pre>
      * Deletes a single Collector - changes state of collector to "Deleting".
+     * Background jobs does final deletion thorugh producer api.
      * </pre>
      */
     default void deleteCollector(
@@ -714,7 +715,7 @@ default void pauseCollector(
    * Base class for the server implementation of the service RapidMigrationAssessment.
    *
    * <pre>
-   * Rapid Migration Assessment service
+   * Service describing handlers for resources.
    * </pre>
    */
   public abstract static class RapidMigrationAssessmentImplBase
@@ -730,7 +731,7 @@ public final io.grpc.ServerServiceDefinition bindService() {
    * A stub to allow clients to do asynchronous rpc calls to service RapidMigrationAssessment.
    *
    * <pre>
-   * Rapid Migration Assessment service
+   * Service describing handlers for resources.
    * </pre>
    */
   public static final class RapidMigrationAssessmentStub
@@ -851,6 +852,7 @@ public void updateCollector(
      *
      * <pre>
      * Deletes a single Collector - changes state of collector to "Deleting".
+     * Background jobs does final deletion thorugh producer api.
      * </pre>
      */
     public void deleteCollector(
@@ -915,7 +917,7 @@ public void pauseCollector(
    * A stub to allow clients to do synchronous rpc calls to service RapidMigrationAssessment.
    *
    * <pre>
-   * Rapid Migration Assessment service
+   * Service describing handlers for resources.
    * </pre>
    */
   public static final class RapidMigrationAssessmentBlockingStub
@@ -1015,6 +1017,7 @@ public com.google.longrunning.Operation updateCollector(
      *
      * <pre>
      * Deletes a single Collector - changes state of collector to "Deleting".
+     * Background jobs does final deletion thorugh producer api.
      * </pre>
      */
     public com.google.longrunning.Operation deleteCollector(
@@ -1068,7 +1071,7 @@ public com.google.longrunning.Operation pauseCollector(
    * RapidMigrationAssessment.
    *
    * <pre>
-   * Rapid Migration Assessment service
+   * Service describing handlers for resources.
    * </pre>
    */
   public static final class RapidMigrationAssessmentFutureStub
@@ -1174,6 +1177,7 @@ protected RapidMigrationAssessmentFutureStub build(
      *
      * <pre>
      * Deletes a single Collector - changes state of collector to "Deleting".
+     * Background jobs does final deletion thorugh producer api.
      * </pre>
      */
     public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation>

java-rapidmigrationassessment/proto-google-cloud-rapidmigrationassessment-v1/src/main/java/com/google/cloud/rapidmigrationassessment/v1/RapidMigrationAssessmentProto.java

@@ -140,75 +140,74 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "ampB\004\342A\001\003\022\024\n\006target\030\003 \001(\tB\004\342A\001\003\022\022\n\004verb\030"
           + "\004 \001(\tB\004\342A\001\003\022\034\n\016status_message\030\005 \001(\tB\004\342A\001"
           + "\003\022$\n\026requested_cancellation\030\006 \001(\010B\004\342A\001\003\022"
-          + "\031\n\013api_version\030\007 \001(\tB\004\342A\001\0032\341\022\n\030RapidMigr"
+          + "\031\n\013api_version\030\007 \001(\tB\004\342A\001\0032\267\022\n\030RapidMigr"
           + "ationAssessment\022\367\001\n\017CreateCollector\022@.go"
           + "ogle.cloud.rapidmigrationassessment.v1.C"
           + "reateCollectorRequest\032\035.google.longrunni"
           + "ng.Operation\"\202\001\312A\036\n\tCollector\022\021Operation"
           + "Metadata\332A\035parent,collector,collector_id"
           + "\202\323\344\223\002;\"./v1/{parent=projects/*/locations"
-          + "/*}/collectors:\tcollector\022\231\002\n\020CreateAnno"
+          + "/*}/collectors:\tcollector\022\357\001\n\020CreateAnno"
           + "tation\022A.google.cloud.rapidmigrationasse"
           + "ssment.v1.CreateAnnotationRequest\032\035.goog"
-          + "le.longrunning.Operation\"\242\001\312AH\n3google.c"
+          + "le.longrunning.Operation\"y\312A\037\n\nAnnotatio"
+          + "n\022\021OperationMetadata\332A\021parent,annotation"
+          + "\202\323\344\223\002=\"//v1/{parent=projects/*/locations"
+          + "/*}/annotations:\nannotation\022\305\001\n\rGetAnnot"
+          + "ation\022>.google.cloud.rapidmigrationasses"
+          + "sment.v1.GetAnnotationRequest\0324.google.c"
           + "loud.rapidmigrationassessment.v1.Annotat"
-          + "ion\022\021OperationMetadata\332A\021parent,annotati"
-          + "on\202\323\344\223\002=\"//v1/{parent=projects/*/locatio"
-          + "ns/*}/annotations:\nannotation\022\305\001\n\rGetAnn"
-          + "otation\022>.google.cloud.rapidmigrationass"
-          + "essment.v1.GetAnnotationRequest\0324.google"
-          + ".cloud.rapidmigrationassessment.v1.Annot"
-          + "ation\">\332A\004name\202\323\344\223\0021\022//v1/{name=projects"
-          + "/*/locations/*/annotations/*}\022\324\001\n\016ListCo"
-          + "llectors\022?.google.cloud.rapidmigrationas"
-          + "sessment.v1.ListCollectorsRequest\032@.goog"
-          + "le.cloud.rapidmigrationassessment.v1.Lis"
-          + "tCollectorsResponse\"?\332A\006parent\202\323\344\223\0020\022./v"
-          + "1/{parent=projects/*/locations/*}/collec"
-          + "tors\022\301\001\n\014GetCollector\022=.google.cloud.rap"
-          + "idmigrationassessment.v1.GetCollectorReq"
-          + "uest\0323.google.cloud.rapidmigrationassess"
-          + "ment.v1.Collector\"=\332A\004name\202\323\344\223\0020\022./v1/{n"
-          + "ame=projects/*/locations/*/collectors/*}"
-          + "\022\371\001\n\017UpdateCollector\022@.google.cloud.rapi"
-          + "dmigrationassessment.v1.UpdateCollectorR"
-          + "equest\032\035.google.longrunning.Operation\"\204\001"
-          + "\312A\036\n\tCollector\022\021OperationMetadata\332A\025coll"
-          + "ector,update_mask\202\323\344\223\002E28/v1/{collector."
-          + "name=projects/*/locations/*/collectors/*"
-          + "}:\tcollector\022\322\001\n\017DeleteCollector\022@.googl"
-          + "e.cloud.rapidmigrationassessment.v1.Dele"
-          + "teCollectorRequest\032\035.google.longrunning."
-          + "Operation\"^\312A\036\n\tCollector\022\021OperationMeta"
-          + "data\332A\004name\202\323\344\223\0020*./v1/{name=projects/*/"
-          + "locations/*/collectors/*}\022\334\001\n\017ResumeColl"
-          + "ector\022@.google.cloud.rapidmigrationasses"
-          + "sment.v1.ResumeCollectorRequest\032\035.google"
-          + ".longrunning.Operation\"h\312A\036\n\tCollector\022\021"
-          + "OperationMetadata\332A\004name\202\323\344\223\002:\"5/v1/{nam"
-          + "e=projects/*/locations/*/collectors/*}:r"
-          + "esume:\001*\022\342\001\n\021RegisterCollector\022B.google."
-          + "cloud.rapidmigrationassessment.v1.Regist"
-          + "erCollectorRequest\032\035.google.longrunning."
-          + "Operation\"j\312A\036\n\tCollector\022\021OperationMeta"
-          + "data\332A\004name\202\323\344\223\002<\"7/v1/{name=projects/*/"
-          + "locations/*/collectors/*}:register:\001*\022\331\001"
-          + "\n\016PauseCollector\022?.google.cloud.rapidmig"
-          + "rationassessment.v1.PauseCollectorReques"
-          + "t\032\035.google.longrunning.Operation\"g\312A\036\n\tC"
-          + "ollector\022\021OperationMetadata\332A\004name\202\323\344\223\0029"
-          + "\"4/v1/{name=projects/*/locations/*/colle"
-          + "ctors/*}:pause:\001*\032[\312A\'rapidmigrationasse"
-          + "ssment.googleapis.com\322A.https://www.goog"
-          + "leapis.com/auth/cloud-platformB\275\002\n,com.g"
-          + "oogle.cloud.rapidmigrationassessment.v1B"
-          + "\035RapidMigrationAssessmentProtoP\001Zhcloud."
-          + "google.com/go/rapidmigrationassessment/a"
-          + "piv1/rapidmigrationassessmentpb;rapidmig"
-          + "rationassessmentpb\252\002(Google.Cloud.RapidM"
-          + "igrationAssessment.V1\312\002(Google\\Cloud\\Rap"
-          + "idMigrationAssessment\\V1\352\002+Google::Cloud"
-          + "::RapidMigrationAssessment::V1b\006proto3"
+          + "ion\">\332A\004name\202\323\344\223\0021\022//v1/{name=projects/*"
+          + "/locations/*/annotations/*}\022\324\001\n\016ListColl"
+          + "ectors\022?.google.cloud.rapidmigrationasse"
+          + "ssment.v1.ListCollectorsRequest\032@.google"
+          + ".cloud.rapidmigrationassessment.v1.ListC"
+          + "ollectorsResponse\"?\332A\006parent\202\323\344\223\0020\022./v1/"
+          + "{parent=projects/*/locations/*}/collecto"
+          + "rs\022\301\001\n\014GetCollector\022=.google.cloud.rapid"
+          + "migrationassessment.v1.GetCollectorReque"
+          + "st\0323.google.cloud.rapidmigrationassessme"
+          + "nt.v1.Collector\"=\332A\004name\202\323\344\223\0020\022./v1/{nam"
+          + "e=projects/*/locations/*/collectors/*}\022\371"
+          + "\001\n\017UpdateCollector\022@.google.cloud.rapidm"
+          + "igrationassessment.v1.UpdateCollectorReq"
+          + "uest\032\035.google.longrunning.Operation\"\204\001\312A"
+          + "\036\n\tCollector\022\021OperationMetadata\332A\025collec"
+          + "tor,update_mask\202\323\344\223\002E28/v1/{collector.na"
+          + "me=projects/*/locations/*/collectors/*}:"
+          + "\tcollector\022\322\001\n\017DeleteCollector\022@.google."
+          + "cloud.rapidmigrationassessment.v1.Delete"
+          + "CollectorRequest\032\035.google.longrunning.Op"
+          + "eration\"^\312A\036\n\tCollector\022\021OperationMetada"
+          + "ta\332A\004name\202\323\344\223\0020*./v1/{name=projects/*/lo"
+          + "cations/*/collectors/*}\022\334\001\n\017ResumeCollec"
+          + "tor\022@.google.cloud.rapidmigrationassessm"
+          + "ent.v1.ResumeCollectorRequest\032\035.google.l"
+          + "ongrunning.Operation\"h\312A\036\n\tCollector\022\021Op"
+          + "erationMetadata\332A\004name\202\323\344\223\002:\"5/v1/{name="
+          + "projects/*/locations/*/collectors/*}:res"
+          + "ume:\001*\022\342\001\n\021RegisterCollector\022B.google.cl"
+          + "oud.rapidmigrationassessment.v1.Register"
+          + "CollectorRequest\032\035.google.longrunning.Op"
+          + "eration\"j\312A\036\n\tCollector\022\021OperationMetada"
+          + "ta\332A\004name\202\323\344\223\002<\"7/v1/{name=projects/*/lo"
+          + "cations/*/collectors/*}:register:\001*\022\331\001\n\016"
+          + "PauseCollector\022?.google.cloud.rapidmigra"
+          + "tionassessment.v1.PauseCollectorRequest\032"
+          + "\035.google.longrunning.Operation\"g\312A\036\n\tCol"
+          + "lector\022\021OperationMetadata\332A\004name\202\323\344\223\0029\"4"
+          + "/v1/{name=projects/*/locations/*/collect"
+          + "ors/*}:pause:\001*\032[\312A\'rapidmigrationassess"
+          + "ment.googleapis.com\322A.https://www.google"
+          + "apis.com/auth/cloud-platformB\275\002\n,com.goo"
+          + "gle.cloud.rapidmigrationassessment.v1B\035R"
+          + "apidMigrationAssessmentProtoP\001Zhcloud.go"
+          + "ogle.com/go/rapidmigrationassessment/api"
+          + "v1/rapidmigrationassessmentpb;rapidmigra"
+          + "tionassessmentpb\252\002(Google.Cloud.RapidMig"
+          + "rationAssessment.V1\312\002(Google\\Cloud\\Rapid"
+          + "MigrationAssessment\\V1\352\002+Google::Cloud::"
+          + "RapidMigrationAssessment::V1b\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(

java-rapidmigrationassessment/proto-google-cloud-rapidmigrationassessment-v1/src/main/proto/google/cloud/rapidmigrationassessment/v1/rapidmigrationassessment.proto

@@ -33,7 +33,7 @@ option java_package = "com.google.cloud.rapidmigrationassessment.v1";
 option php_namespace = "Google\\Cloud\\RapidMigrationAssessment\\V1";
 option ruby_package = "Google::Cloud::RapidMigrationAssessment::V1";
 
-// Rapid Migration Assessment service
+// Service describing handlers for resources.
 service RapidMigrationAssessment {
   option (google.api.default_host) = "rapidmigrationassessment.googleapis.com";
   option (google.api.oauth_scopes) =
@@ -63,7 +63,7 @@ service RapidMigrationAssessment {
     };
     option (google.api.method_signature) = "parent,annotation";
     option (google.longrunning.operation_info) = {
-      response_type: "google.cloud.rapidmigrationassessment.v1.Annotation"
+      response_type: "Annotation"
       metadata_type: "OperationMetadata"
     };
   }
@@ -107,6 +107,7 @@ service RapidMigrationAssessment {
   }
 
   // Deletes a single Collector - changes state of collector to "Deleting".
+  // Background jobs does final deletion thorugh producer api.
   rpc DeleteCollector(DeleteCollectorRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {