functions.rb in google-cloud-functions-v1-0.3.3

- old
+ new

@@ -30,21 +30,25 @@
         # @!attribute [rw] description
         #   @return [::String]
         #     User-provided description of a function.
         # @!attribute [rw] source_archive_url
         #   @return [::String]
-        #     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.
         # @!attribute [rw] source_repository
         #   @return [::Google::Cloud::Functions::V1::SourceRepository]
         #     **Beta Feature**
         #
         #     The source repository where a function is hosted.
         # @!attribute [rw] source_upload_url
         #   @return [::String]
         #     The Google Cloud Storage signed URL used for source uploading, generated
-        #     by [google.cloud.functions.v1.GenerateUploadUrl][]
+        #     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)
         # @!attribute [rw] https_trigger
         #   @return [::Google::Cloud::Functions::V1::HttpsTrigger]
         #     An HTTPS endpoint type of source that can be triggered via URL.
         # @!attribute [rw] event_trigger
         #   @return [::Google::Cloud::Functions::V1::EventTrigger]
@@ -64,11 +68,11 @@
         #   @return [::String]
         #     The runtime in which to run the function. Required when 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).
         # @!attribute [rw] timeout
         #   @return [::Google::Protobuf::Duration]
         #     The function execution timeout. Execution is considered failed and
         #     can be terminated if the function is not completed at the end of the
         #     timeout period. Defaults to 60 seconds.
@@ -99,11 +103,11 @@
         #     either the fully-qualified URI, or the short name of the network resource.
         #     If the short network name is used, the network must belong to the same
         #     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.
         #
         #     See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for