Update after review comments

vision/beta/cloud-client/src/main/java/com/example/vision/AsyncBatchAnnotateImagesGcs.java

@@ -16,7 +16,7 @@
 
 package com.example.vision;
 
-// [START vision_detect_async_batch_annotate_images_beta]
+// [START vision_async_batch_annotate_images_beta]
 
 import com.google.api.core.ApiFuture;
 import com.google.api.gax.paging.Page;
@@ -47,16 +47,14 @@
 
 public class AsyncBatchAnnotateImagesGcs {
 
-  /**
-   * Performs asynchronous batch annotation of images on Google Cloud Storage
-   * @param gcsSourcePath The path to the remote file on Google Cloud Storage
-   * @param gcsDestinationPath The path to the annotated image file
-   * @throws Exception on errors
-   */
+  // Performs asynchronous batch annotation of images on Google Cloud Storage
 
   public static void asyncBatchAnnotateImagesGcs(String gcsSourcePath, String gcsDestinationPath)
       throws Exception {
 
+    // String gcsSourcePath = "gs://YOUR_BUCKET_ID/path_to_your_data";
+    // String gcsDestinationPath = "gs://YOUR_BUCKET_ID/path_to_store_annotation";
+
     try (ImageAnnotatorClient client = ImageAnnotatorClient.create()) {
       List<AnnotateImageRequest> requests = new ArrayList<>();
       System.out.println("source: " + gcsSourcePath);
@@ -158,4 +156,4 @@ public static void asyncBatchAnnotateImagesGcs(String gcsSourcePath, String gcsD
   }
 }
 
-// [END vision_detect_async_batch_annotate_images_beta]
+// [END vision_async_batch_annotate_images_beta]

vision/beta/cloud-client/src/main/java/com/example/vision/DetectBatchAnnotateFiles.java

@@ -16,7 +16,7 @@
 
 package com.example.vision;
 
-// [START vision_detect_batch_annotate_files_beta]
+// [START vision_batch_annotate_files_beta]
 
 import com.google.api.core.ApiFuture;
 import com.google.cloud.vision.v1p4beta1.AnnotateFileRequest;
@@ -40,28 +40,20 @@
 import java.util.Arrays;
 import java.util.List;
 
-
 public class DetectBatchAnnotateFiles {
 
-  /**
-   * Performs document feature detection on a local PDF/TIFF/GIF file.
-   * While your PDF file may have several pages, this API can process up to 5 pages only.
-   * @param filePath The local file path e.g. "path/to/file.pdf"
-   * @throws Exception on errors
-   */
+  // Performs document feature detection on a local PDF/TIFF/GIF file.
+
   public static void detectBatchAnnotateFiles(String filePath) {
+    // String filePath = "path/to/your_file";
 
-    // Initialize the client that will be used to send requests. This client only needs to be
-    // created
-    // once, and can be reused for multiple requests. After completing all of your requests, call
-    // the "close" method on the client to safely clean up any remaining background resources.
     try (ImageAnnotatorClient client = ImageAnnotatorClient.create()) {
-      //Annotate the first two pages and the last one (max 5 pages)
-      //First page starts at 1, and not 0. Last page is -1.
-      List<Integer> pages = Arrays.asList(1,2,-1);
+      // Annotate the first two pages and the last one (max 5 pages)
+      // First page starts at 1, and not 0. Last page is -1.
+      List<Integer> pages = Arrays.asList(1, 2, -1);
       ByteString pdfBytes = ByteString.readFrom(new FileInputStream(filePath));
       Feature feat = Feature.newBuilder().setType(Type.DOCUMENT_TEXT_DETECTION).build();
-      //Other supported mime types : 'image/tiff' or 'image/gif'
+      // Other supported mime types : 'image/tiff' or 'image/gif'
       InputConfig inputConfig =
           InputConfig.newBuilder().setMimeType("application/pdf").setContent(pdfBytes).build();
       AnnotateFileRequest request =
@@ -77,8 +69,8 @@ public static void detectBatchAnnotateFiles(String filePath) {
       ApiFuture<BatchAnnotateFilesResponse> future =
           client.batchAnnotateFilesCallable().futureCall(batchAnnotateFilesRequest);
       BatchAnnotateFilesResponse response = future.get();
-      client.close();
-      //Getting the first response
+
+      // Getting the first response
       AnnotateFileResponse annotateFileResponse = response.getResponses(0);
       // For full list of available annotations, see http://g.co/cloud/vision/docs
       TextAnnotation textAnnotation = annotateFileResponse.getResponses(0).getFullTextAnnotation();
@@ -115,4 +107,4 @@ public static void detectBatchAnnotateFiles(String filePath) {
     }
   }
 }
-// [END vision_detect_batch_annotate_files_beta]
+// [END vision_batch_annotate_files_beta]

vision/beta/cloud-client/src/main/java/com/example/vision/DetectBatchAnnotateFilesGcs.java

@@ -16,7 +16,7 @@
 
 package com.example.vision;
 
-// [START vision_fulltext_detection_pdf_gcs_beta]
+// [START vision_batch_annotate_files_gcs_beta]
 
 import com.google.api.core.ApiFuture;
 import com.google.cloud.vision.v1p4beta1.AnnotateFileRequest;
@@ -41,19 +41,11 @@
 
 public class DetectBatchAnnotateFilesGcs {
 
-  /**
-   * Performs document feature detection on a remote PDF/TIFF/GIF file on Google Cloud Storage.
-   * While your PDF file may have several pages, this API can process up to 5 pages only.
-   *
-   * @param gcsPath The path to the remote file on Google Cloud Storage
-   * @throws Exception on errors
-   */
-  public static void detectDocumentFeaturesGcs(String gcsPath) {
+  // Performs document feature detection on a remote PDF/TIFF/GIF file on Google Cloud Storage.
+
+  public static void detectBatchAnnotateFilesGcs(String gcsPath) {
+    // String gcsPath = "gs://Your_BUCKET_ID/path_to_your_data";
 
-    // Initialize the client that will be used to send requests. This client only needs to be
-    // created
-    // once, and can be reused for multiple requests. After completing all of your requests, call
-    // the "close" method on the client to safely clean up any remaining background resources.
     try (ImageAnnotatorClient client = ImageAnnotatorClient.create()) {
       // Annotate the first two pages and the last one (max 5 pages)
       // First page starts at 1, and not 0. Last page is -1.
@@ -114,4 +106,4 @@ public static void detectDocumentFeaturesGcs(String gcsPath) {
     }
   }
 }
-// [END vision_fulltext_detection_pdf_gcs_beta]
+// [END vision_batch_annotate_files_gcs_beta]

vision/beta/cloud-client/src/test/java/com/example/vision/DetectIT.java

@@ -112,7 +112,7 @@ public void testDetectDocumentFeatures() {
   @Test
   public void testDetectDocumentFeaturesGcs() throws Exception {
     // Act
-    DetectBatchAnnotateFilesGcs.detectDocumentFeaturesGcs(
+    DetectBatchAnnotateFilesGcs.detectBatchAnnotateFilesGcs(
         "gs://cloud-samples-data/video/kafka.pdf");
 
     // Assert