feat: Enable gpu driver version field on v1

docs: Mark `order_by` field in `ListTasksRequest` as not implemented.
docs: Improve url examples in comments

PiperOrigin-RevId: 550631094

google/cloud/batch/v1alpha/batch.proto

@@ -177,9 +177,9 @@ message ListJobsRequest {
   // List filter.
   string filter = 4;
 
-  // Sort results. Supported are "name", "name desc", "create_time",
-  // "create_time desc", and "".
-  string order_by = 5;
+  // Optional. Sort results. Supported are "name", "name desc", "create_time",
+  // and "create_time desc".
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Page size.
   int32 page_size = 2;
@@ -215,8 +215,7 @@ message ListTasksRequest {
   // State=RUNNING
   string filter = 2;
 
-  // Sort results. Supported are "name", "name desc", "create_time",
-  // "create_time desc", and "".
+  // Not implemented.
   string order_by = 5;
 
   // Page size.

google/cloud/batch/v1alpha/job.proto

@@ -313,21 +313,24 @@ message AllocationPolicy {
   message Disk {
     // A data source from which a PD will be created.
     oneof data_source {
-      // Name of a public or custom image used as the data source.
+      // Name of an image used as the data source.
       // For example, the following are all valid URLs:
       //
       // * Specify the image by its family name:
-      // projects/{project}/global/images/family/{image_family}
+      // <pre><code>projects/<var
+      // class="apiparam">project</var>/global/images/family/<var
+      // class="apiparam">image_family</var></code></pre>
       // * Specify the image version:
-      // projects/{project}/global/images/{image_version}
-      //
+      // <pre>projects/<var
+      // class="apiparam">project</var>/global/images/<var
+      // class="apiparam">image_version</var></code></pre>
       // You can also use Batch customized image in short names.
       // The following image values are supported for a boot disk:
       //
-      // * "batch-debian": use Batch Debian images.
-      // * "batch-centos": use Batch CentOS images.
-      // * "batch-cos": use Batch Container-Optimized images.
-      // * "batch-hpc-centos": use Batch HPC CentOS images.
+      // * `batch-debian`: use Batch Debian images.
+      // * `batch-centos`: use Batch CentOS images.
+      // * `batch-cos`: use Batch Container-Optimized images.
+      // * `batch-hpc-centos`: use Batch HPC CentOS images.
       string image = 4;
 
       // Name of a snapshot used as the data source.
@@ -388,10 +391,14 @@ message AllocationPolicy {
     // Deprecated: please use instances[0].install_gpu_drivers instead.
     bool install_gpu_drivers = 3 [deprecated = true];
 
-    // The accelerator driver version that will be installed for this type.
+    // Optional. The NVIDIA GPU driver version that should be installed for this
+    // type.
     //
-    // Not yet implemented.
-    string driver_version = 4;
+    // You can define the specific driver version such as "470.103.01",
+    // following the driver version requirements in
+    // https://cloud.google.com/compute/docs/gpus/install-drivers-gpu#minimum-driver.
+    // Batch will install the specific accelerator driver if qualified.
+    string driver_version = 4 [(google.api.field_behavior) = OPTIONAL];
   }
 
   // InstancePolicy describes an instance type and resources attached to each VM
@@ -444,6 +451,12 @@ message AllocationPolicy {
     // third party location and install them for GPUs specified in
     // policy.accelerators or instance_template on their behalf. Default is
     // false.
+    //
+    // For Container-Optimized Image cases, Batch will install the
+    // accelerator driver following milestones of
+    // https://cloud.google.com/container-optimized-os/docs/release-notes. For
+    // non Container-Optimized Image cases, following
+    // https://github.com/GoogleCloudPlatform/compute-gpu-installation/blob/main/linux/install_gpu_driver.py.
     bool install_gpu_drivers = 3;
   }
 
@@ -453,20 +466,30 @@ message AllocationPolicy {
     // You can specify the network as a full or partial URL.
     //
     // For example, the following are all valid URLs:
-    //
-    // * https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}
-    // * projects/{project}/global/networks/{network}
-    // * global/networks/{network}
+    // <pre><code>https://www.googleapis.com/compute/v1/projects/<var
+    // class="apiparam">project</var>/global/networks/<var
+    // class="apiparam">network</var></code></pre>
+    // <pre><code>projects/<var
+    // class="apiparam">project</var>/global/networks/<var
+    // class="apiparam">network</var></code></pre>
+    // <pre><code>global/networks/<var
+    // class="apiparam">network</var></code></pre>
     string network = 1;
 
     // The URL of an existing subnetwork resource in the network.
     // You can specify the subnetwork as a full or partial URL.
     //
     // For example, the following are all valid URLs:
-    //
-    // * https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetwork}
-    // * projects/{project}/regions/{region}/subnetworks/{subnetwork}
-    // * regions/{region}/subnetworks/{subnetwork}
+    // <pre><code>https://www.googleapis.com/compute/v1/projects/<var
+    // class="apiparam">project</var>/regions/<var
+    // class="apiparam">region</var>/subnetworks/<var
+    // class="apiparam">subnetwork</var></code></pre>
+    // <pre><code>projects/<var class="apiparam">project</var>/regions/<var
+    // class="apiparam">region</var>/subnetworks/<var
+    // class="apiparam">subnetwork</var></code></pre>
+    // <pre><code>regions/<var
+    // class="apiparam">region</var>/subnetworks/<var
+    // class="apiparam">subnetwork</var></code></pre>
     string subnetwork = 2;
 
     // Default is false (with an external IP address). Required if