docs: minor formatting fixes to Cloud Functions reference docs

Google APIs · copybara-github · commit a75aa070342e · 2021-08-17T08:41:47.000-07:00
PiperOrigin-RevId: 391298623
diff --git a/google/cloud/functions/v1/functions.proto b/google/cloud/functions/v1/functions.proto
@@ -233,7 +233,7 @@ message CloudFunction {
 
   // The location of the function source code.
   oneof source_code {
-    // The Google Cloud Storage URL, starting with gs://, pointing to the zip
+    // The Google Cloud Storage URL, starting with `gs://`, pointing to the zip
     // archive which contains the function.
     string source_archive_url = 3;
 
@@ -245,9 +245,9 @@ message CloudFunction {
     // The Google Cloud Storage signed URL used for source uploading, generated
     // by calling [google.cloud.functions.v1.GenerateUploadUrl].
     //
-    // The signature is validated on write methods {Create, Update}
-    // The signature is stripped from the Function object on read methods {Get,
-    // List}
+    // The signature is validated on write methods (Create, Update)
+    // The signature is stripped from the Function object on read methods (Get,
+    // List)
     string source_upload_url = 16;
   }
 
@@ -275,7 +275,7 @@ message CloudFunction {
   // function, optional when updating an existing function. For a complete
   // list of possible choices, see the
   // [`gcloud` command
-  // reference](/sdk/gcloud/reference/functions/deploy#--runtime).
+  // reference](https://cloud.google.com/sdk/gcloud/reference/functions/deploy#--runtime).
   string runtime = 19;
 
   // The function execution timeout. Execution is considered failed and
@@ -310,8 +310,8 @@ message CloudFunction {
   // project. Otherwise, it must belong to a project within the same
   // organization. The format of this field is either
   // `projects/{project}/global/networks/{network}` or `{network}`, where
-  // {project} is a project id where the network is defined, and {network} is
-  // the short name of the network.
+  // `{project}` is a project id where the network is defined, and `{network}`
+  // is the short name of the network.
   //
   // This field is mutually exclusive with `vpc_connector` and will be replaced
   // by it.
diff --git a/google/cloud/functions/v1/operations.proto b/google/cloud/functions/v1/operations.proto
@@ -43,7 +43,7 @@ enum OperationType {
 // Metadata describing an [Operation][google.longrunning.Operation]
 message OperationMetadataV1 {
   // Target of the operation - for example
-  // projects/project-1/locations/region-1/functions/function-1
+  // `projects/project-1/locations/region-1/functions/function-1`
   string target = 1;
 
   // Type of operation.
