diff --git a/google/cloud/functions_v1/types/functions.py b/google/cloud/functions_v1/types/functions.py
index eb2e29e..c53b8b1 100644
--- a/google/cloud/functions_v1/types/functions.py
+++ b/google/cloud/functions_v1/types/functions.py
@@ -68,9 +68,8 @@ class CloudFunction(proto.Message):
         description (str):
             User-provided description of a function.
         source_archive_url (str):
-            The Google Cloud Storage URL, starting with
-            gs://, pointing to the zip archive which
-            contains the function.
+            The Google Cloud Storage URL, starting with ``gs://``,
+            pointing to the zip archive which contains the function.
         source_repository (google.cloud.functions_v1.types.SourceRepository):
             **Beta Feature**
 
@@ -80,9 +79,9 @@ class CloudFunction(proto.Message):
             uploading, generated by calling
             [google.cloud.functions.v1.GenerateUploadUrl].
 
-            The signature is validated on write methods {Create, Update}
+            The signature is validated on write methods (Create, Update)
             The signature is stripped from the Function object on read
-            methods {Get, List}
+            methods (Get, List)
         https_trigger (google.cloud.functions_v1.types.HttpsTrigger):
             An HTTPS endpoint type of source that can be
             triggered via URL.
@@ -105,7 +104,7 @@ class CloudFunction(proto.Message):
             deploying a new 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>`__.
         timeout (google.protobuf.duration_pb2.Duration):
             The function execution timeout. Execution is
             considered failed and can be terminated if the
@@ -137,9 +136,9 @@ class CloudFunction(proto.Message):
             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.
+            ``{network}``, where ``{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/types/operations.py b/google/cloud/functions_v1/types/operations.py
index 49b85fb..59c5f85 100644
--- a/google/cloud/functions_v1/types/operations.py
+++ b/google/cloud/functions_v1/types/operations.py
@@ -38,7 +38,7 @@ class OperationMetadataV1(proto.Message):
     Attributes:
         target (str):
             Target of the operation - for example
-            projects/project-1/locations/region-1/functions/function-1
+            ``projects/project-1/locations/region-1/functions/function-1``
         type_ (google.cloud.functions_v1.types.OperationType):
             Type of operation.
         request (google.protobuf.any_pb2.Any):