docs: fix typos and docstring formatting

Google APIs · copybara-github · commit 1645638695ba · 2021-10-18T11:17:20.000-07:00
Committer: @parthea PiperOrigin-RevId: 404010579
diff --git a/google/cloud/notebooks/v1/instance.proto b/google/cloud/notebooks/v1/instance.proto
@@ -83,12 +83,13 @@ message Instance {
       // The ID of a supported feature. Read  Enabling guest operating system
       // features to see a list of available options.
       // Valid values:
-      //     FEATURE_TYPE_UNSPECIFIED
-      //     MULTI_IP_SUBNET
-      //     SECURE_BOOT
-      //     UEFI_COMPATIBLE
-      //     VIRTIO_SCSI_MULTIQUEUE
-      //     WINDOWS
+      //
+      // * FEATURE_TYPE_UNSPECIFIED
+      // * MULTI_IP_SUBNET
+      // * SECURE_BOOT
+      // * UEFI_COMPATIBLE
+      // * VIRTIO_SCSI_MULTIQUEUE
+      // * WINDOWS
       string type = 1;
     }
 
@@ -130,8 +131,9 @@ message Instance {
     // SCSI. For performance characteristics of SCSI over NVMe, see Local SSD
     // performance.
     // Valid values:
-    //     NVME
-    //     SCSI
+    //
+    // * NVME
+    // * SCSI
     string interface = 7;
 
     // Type of the resource. Always compute#attachedDisk for attached
@@ -146,8 +148,9 @@ message Instance {
     // The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If
     // not specified, the default is to attach the disk in READ_WRITE mode.
     // Valid values:
-    //     READ_ONLY
-    //     READ_WRITE
+    //
+    // * READ_ONLY
+    // * READ_WRITE
     string mode = 10;
 
     // Indicates a valid partial or full URL to an existing Persistent Disk
@@ -156,8 +159,9 @@ message Instance {
 
     // Indicates the type of the disk, either SCRATCH or PERSISTENT.
     // Valid values:
-    //     PERSISTENT
-    //     SCRATCH
+    //
+    // * PERSISTENT
+    // * SCRATCH
     string type = 12;
   }
 
diff --git a/google/cloud/notebooks/v1/runtime.proto b/google/cloud/notebooks/v1/runtime.proto
@@ -185,7 +185,7 @@ message EncryptionConfig {
   string kms_key = 1;
 }
 
-// An Local attached disk resource.
+// A Local attached disk resource.
 message LocalDisk {
   // Optional. A list of features to enable on the guest operating system.
   // Applicable only for bootable images.
@@ -252,8 +252,9 @@ message LocalDisk {
   // in any other format than SCSI. Local SSDs can use either NVME or SCSI. For
   // performance characteristics of SCSI over NVMe, see Local SSD performance.
   // Valid values:
-  //     NVME
-  //     SCSI
+  //
+  // * NVME
+  // * SCSI
   string interface = 7;
 
   // Output only. Type of the resource. Always compute#attachedDisk for attached disks.
@@ -265,8 +266,9 @@ message LocalDisk {
   // The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If
   // not specified, the default is to attach the disk in READ_WRITE mode.
   // Valid values:
-  //     READ_ONLY
-  //     READ_WRITE
+  //
+  // * READ_ONLY
+  // * READ_WRITE
   string mode = 10;
 
   // Specifies a valid partial or full URL to an existing Persistent Disk
@@ -276,8 +278,9 @@ message LocalDisk {
   // Specifies the type of the disk, either SCRATCH or PERSISTENT. If not
   // specified, the default is PERSISTENT.
   // Valid values:
-  //     PERSISTENT
-  //     SCRATCH
+  //
+  // * PERSISTENT
+  // * SCRATCH
   string type = 12;
 }
 
@@ -367,7 +370,7 @@ message RuntimeSoftwareConfig {
   // Default: True
   optional bool idle_shutdown = 3;
 
-  // Time in minutes to wait before shuting down runtime. Default: 180 minutes
+  // Time in minutes to wait before shutting down runtime. Default: 180 minutes
   int32 idle_shutdown_timeout = 4;
 
   // Install Nvidia Driver automatically.
