docs: updated comments

Google APIs · copybara-github · commit f9bd3d00ef20 · 2023-10-31T11:10:54.000-07:00
PiperOrigin-RevId: 578242041
diff --git a/google/cloud/documentai/v1/document_io.proto b/google/cloud/documentai/v1/document_io.proto
@@ -124,8 +124,8 @@ message OcrConfig {
 
   // Configurations for premium OCR features.
   message PremiumFeatures {
-    // Turn on selection mark detector in OCR engine. Only available in OCR 2.0+
-    // processors.
+    // Turn on selection mark detector in OCR engine. Only available in OCR 2.0
+    // (and later) processors.
     bool enable_selection_mark_detection = 3;
 
     // Turn on font identification model and return font style information.
@@ -166,7 +166,7 @@ message OcrConfig {
   bool compute_style_info = 8 [deprecated = true];
 
   // Turn off character box detector in OCR engine. Character box detection is
-  // enabled by default in OCR 2.0+ processors.
+  // enabled by default in OCR 2.0 (and later) processors.
   bool disable_character_boxes_detection = 10;
 
   // Configurations for premium OCR features.
diff --git a/google/cloud/documentai/v1/document_processor_service.proto b/google/cloud/documentai/v1/document_processor_service.proto
@@ -334,17 +334,19 @@ message ProcessOptions {
     repeated int32 pages = 1 [(google.api.field_behavior) = OPTIONAL];
   }
 
-  // A subset of pages to process. If not specified, all pages will be
-  // processed. NOTICE: If any of the page range is set, we will extract and
-  // process only the given pages from the document. In the output document,
-  // the page_number is referring to the page number in the original document.
-  // This config only applies to sync requests.
+  // A subset of pages to process. If not specified, all pages are processed.
+  //  If a page range is set, only the given pages are extracted and processed
+  //  from the document. In the output document,
+  //  [Document.Page.page_number][google.cloud.documentai.v1.Document.Page.page_number]
+  //  refers to the page number in the original document. This configuration
+  //  only applies to sync requests. `page_range` can be only one of the
+  //  following:
   oneof page_range {
     // Which pages to process (1-indexed).
     IndividualPageSelector individual_page_selector = 5;
 
-    // Only process certain pages from the start, process all if the document
-    // has less pages.
+    // Only process certain pages from the start. Process all if the document
+    // has fewer pages.
     int32 from_start = 6;
 
     // Only process certain pages from the end, same as above.
