chore: preview YARD formatting fixes from gapic-generator-ruby #1337

google-apps-chat-v1/proto_docs/google/apps/card/v1/card.rb

@@ -897,7 +897,7 @@ class Image
         # For example, the following JSON creates a divider:
         #
         # ```
-        # "divider": {}
+        # "divider": \\{}
         # ```
         class Divider
           include ::Google::Protobuf::MessageExts
@@ -1751,7 +1751,7 @@ class Icon
         #     settings under **Customize**.
         # @!attribute [rw] weight
         #   @return [::Integer]
-        #     The stroke weight of the icon. Choose from {100, 200, 300, 400,
+        #     The stroke weight of the icon. Choose from \\{100, 200, 300, 400,
         #     500, 600, 700}. If absent, default value is 400. If any other value is
         #     specified, the default value is used.
         #

google-apps-chat-v1/proto_docs/google/chat/v1/annotation.rb

@@ -29,7 +29,7 @@ module V1
         #
         # Example plain-text message body:
         # ```
-        # Hello @FooBot how are you!"
+        # Hello `@FooBot` how are you!"
         # ```
         #
         # The corresponding annotations metadata:

google-apps-chat-v1/proto_docs/google/chat/v1/space.rb

@@ -338,7 +338,7 @@ class Principal
           #     Optional. Setting for toggling space history on and off.
           # @!attribute [rw] use_at_mention_all
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
-          #     Optional. Setting for using @all in a space.
+          #     Optional. Setting for using `@all` in a space.
           # @!attribute [rw] manage_apps
           #   @return [::Google::Apps::Chat::V1::Space::PermissionSetting]
           #     Optional. Setting for managing apps in a space.

google-apps-chat-v1/proto_docs/google/chat/v1/space_notification_setting.rb

@@ -42,16 +42,16 @@ module NotificationSetting
             # Reserved.
             NOTIFICATION_SETTING_UNSPECIFIED = 0
 
-            # Notifications are triggered by @mentions, followed threads, first
+            # Notifications are triggered by `@mentions`, followed threads, first
             # message of new threads. All new threads are automatically followed,
             # unless manually unfollowed by the user.
             ALL = 1
 
-            # The notification is triggered by @mentions, followed threads, first
+            # The notification is triggered by `@mentions`, followed threads, first
             # message of new threads. Not available for 1:1 direct messages.
             MAIN_CONVERSATIONS = 2
 
-            # The notification is triggered by @mentions, followed threads. Not
+            # The notification is triggered by `@mentions`, followed threads. Not
             # available for 1:1 direct messages.
             FOR_YOU = 3
 

google-cloud-agent_registry-v1/proto_docs/google/cloud/agentregistry/v1/agent.rb

@@ -67,10 +67,10 @@ module V1
         #     Output only. Attributes of the Agent.
         #     Valid values:
         #
-        #      * `agentregistry.googleapis.com/system/Framework`: {"framework":
+        #      * `agentregistry.googleapis.com/system/Framework`: \\{"framework":
         #      "google-adk"} - the agent framework used to develop the Agent. Example
         #      values: "google-adk", "langchain", "custom".
-        #      * `agentregistry.googleapis.com/system/RuntimeIdentity`: {"principal":
+        #      * `agentregistry.googleapis.com/system/RuntimeIdentity`: \\{"principal":
         #      "principal://..."} - the runtime identity associated with the Agent.
         #      * `agentregistry.googleapis.com/system/RuntimeReference`: \\{"uri": "//..."}
         #      - the URI of the underlying resource hosting the Agent, for

google-cloud-agent_registry-v1/proto_docs/google/cloud/agentregistry/v1/mcp_server.rb

@@ -52,7 +52,7 @@ module V1
         #     Output only. Attributes of the MCP Server.
         #     Valid values:
         #
-        #      * `agentregistry.googleapis.com/system/RuntimeIdentity`: {"principal":
+        #      * `agentregistry.googleapis.com/system/RuntimeIdentity`: \\{"principal":
         #      "principal://..."} - the runtime identity associated with the MCP Server.
         #      * `agentregistry.googleapis.com/system/RuntimeReference`: \\{"uri": "//..."}
         #      - the URI of the underlying resource hosting the MCP Server, for

google-cloud-ai_platform-v1/lib/google/cloud/ai_platform/v1/featurestore_online_serving_service/client.rb

@@ -439,7 +439,7 @@ def streaming_read_feature_values request, options = nil
             #   @param entity_type [::String]
             #     Required. The resource name of the EntityType for the entities being
             #     written. Value format:
-            #     `projects/{project}/locations/{location}/featurestores/
+            #     `projects/\\{project}/locations/\\{location}/featurestores/
             #     \\{featurestore}/entityTypes/\\{entityType}`. For example,
             #     for a machine learning model predicting user clicks on a website, an
             #     EntityType ID could be `user`.

google-cloud-ai_platform-v1/lib/google/cloud/ai_platform/v1/featurestore_online_serving_service/rest/client.rb

@@ -422,7 +422,7 @@ def streaming_read_feature_values request, options = nil
               #   @param entity_type [::String]
               #     Required. The resource name of the EntityType for the entities being
               #     written. Value format:
-              #     `projects/{project}/locations/{location}/featurestores/
+              #     `projects/\\{project}/locations/\\{location}/featurestores/
               #     \\{featurestore}/entityTypes/\\{entityType}`. For example,
               #     for a machine learning model predicting user clicks on a website, an
               #     EntityType ID could be `user`.

google-cloud-ai_platform-v1/proto_docs/google/cloud/aiplatform/v1/evaluation_service.rb

@@ -556,7 +556,7 @@ class PredefinedMetricSpec
         #     Required. The type of the computation based metric.
         # @!attribute [rw] parameters
         #   @return [::Google::Protobuf::Struct]
-        #     Optional. A map of parameters for the metric, e.g. {"rouge_type":
+        #     Optional. A map of parameters for the metric, e.g. \\{"rouge_type":
         #     "rougeL"}.
         class ComputationBasedMetricSpec
           include ::Google::Protobuf::MessageExts

google-cloud-ai_platform-v1/proto_docs/google/cloud/aiplatform/v1/featurestore_online_service.rb

@@ -27,7 +27,7 @@ module V1
         #   @return [::String]
         #     Required. The resource name of the EntityType for the entities being
         #     written. Value format:
-        #     `projects/{project}/locations/{location}/featurestores/
+        #     `projects/\\{project}/locations/\\{location}/featurestores/
         #     \\{featurestore}/entityTypes/\\{entityType}`. For example,
         #     for a machine learning model predicting user clicks on a website, an
         #     EntityType ID could be `user`.

google-cloud-ai_platform-v1/proto_docs/google/cloud/aiplatform/v1/tuning_job.rb

@@ -148,7 +148,7 @@ class LabelsEntry
         #     parent model with version 1. Otherwise the version id will be incremented
         #     by 1 from the last version ID in the parent model. E.g.,
         #
-        #     `projects/{project}/locations/{location}/models/{model}@{last_version_id +
+        #     `projects/\\{project}/locations/\\{location}/models/\\{model}@\\{last_version_id +
         #     1}`
         # @!attribute [r] endpoint
         #   @return [::String]

google-cloud-bigtable-admin-v2/proto_docs/google/bigtable/admin/v2/table.rb

@@ -540,7 +540,7 @@ module State
           #   @return [::String]
           #     A globally unique identifier for the backup which cannot be
           #     changed. Values are of the form
-          #     `projects/{project}/instances/{instance}/clusters/{cluster}/
+          #     `projects/\\{project}/instances/\\{instance}/clusters/\\{cluster}/
           #        backups/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`
           #     The final segment of the name must be between 1 and 50 characters
           #     in length.

google-cloud-bigtable-v2/lib/google/cloud/bigtable/v2/bigtable/client.rb

@@ -1333,7 +1333,7 @@ def read_change_stream request, options = nil
             #     `@` character followed by the parameter name (for example, `@firstName`) in
             #     the query string.
             #
-            #     For example, if param_types["firstName"] = Bytes then @firstName will be a
+            #     For example, if param_types["firstName"] = Bytes then `@firstName` will be a
             #     query parameter of type Bytes. The specific `Value` to be used for the
             #     query execution must be sent in `ExecuteQueryRequest` in the `params` map.
             #

google-cloud-bigtable-v2/lib/google/cloud/bigtable/v2/bigtable/rest/client.rb

@@ -1197,7 +1197,7 @@ def read_change_stream request, options = nil
               #     `@` character followed by the parameter name (for example, `@firstName`) in
               #     the query string.
               #
-              #     For example, if param_types["firstName"] = Bytes then @firstName will be a
+              #     For example, if param_types["firstName"] = Bytes then `@firstName` will be a
               #     query parameter of type Bytes. The specific `Value` to be used for the
               #     query execution must be sent in `ExecuteQueryRequest` in the `params` map.
               # @yield [result, operation] Access the result along with the TransportOperation object

google-cloud-bigtable-v2/proto_docs/google/bigtable/v2/bigtable.rb

@@ -926,7 +926,7 @@ class ExecuteQueryResponse
         #     `@` character followed by the parameter name (for example, `@firstName`) in
         #     the query string.
         #
-        #     For example, if param_types["firstName"] = Bytes then @firstName will be a
+        #     For example, if param_types["firstName"] = Bytes then `@firstName` will be a
         #     query parameter of type Bytes. The specific `Value` to be used for the
         #     query execution must be sent in `ExecuteQueryRequest` in the `params` map.
         class PrepareQueryRequest

google-cloud-compute-v1/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    google-cloud-compute-v1 (3.9.0)
+    google-cloud-compute-v1 (3.10.0)
       gapic-common (~> 1.3)
       google-cloud-common (~> 1.0)
       google-cloud-errors (~> 1.0)
@@ -235,7 +235,7 @@ CHECKSUMS
   faraday-retry (2.4.0) sha256=7b79c48fb7e56526faf247b12d94a680071ff40c9fda7cf1ec1549439ad11ebe
   gapic-common (1.3.0) sha256=4e5d9be1effb7366e2cda13c0f44922285d5613ac8de8b9b18c2c835fe4faa91
   google-cloud-common (1.10.0) sha256=f8036aa5a5f6a32d9ccab652f0f52a996ac02f5be83f403075465e8ba99238ee
-  google-cloud-compute-v1 (3.9.0)
+  google-cloud-compute-v1 (3.10.0)
   google-cloud-env (2.4.0) sha256=01cb35ecee5d1c4d1cd4deaed8bb5bddc838e296bcc2a35c5d1ddd07ce40d28d
   google-cloud-errors (1.7.0) sha256=6e682f42d89aae08689f36f28495de629d756da076bafff0003bac7f8042ebb3
   google-logging-utils (0.2.0) sha256=675462b4ea5affa825a3442694ca2d75d0069455a1d0956127207498fca3df7b

google-cloud-config_delivery-v1/proto_docs/google/cloud/configdelivery/v1/config_delivery.rb

@@ -25,7 +25,7 @@ module V1
         # @!attribute [rw] name
         #   @return [::String]
         #     Identifier. Name of the `ResourceBundle`. Format is
-        #     `projects/{project}/locations/{location}/resourceBundle
+        #     `projects/\\{project}/locations/\\{location}/resourceBundle
         #     /[a-z][a-z0-9\-]\\{0,62}`.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]

google-cloud-config_service-v1/proto_docs/google/cloud/config/v1/config.rb

@@ -46,7 +46,7 @@ module V1
         # @!attribute [r] latest_revision
         #   @return [::String]
         #     Output only. Revision name that was most recently applied.
-        #     Format: `projects/{project}/locations/{location}/deployments/{deployment}/
+        #     Format: `projects/\\{project}/locations/\\{location}/deployments/\\{deployment}/
         #     revisions/\\{revision}`
         # @!attribute [r] state_detail
         #   @return [::String]
@@ -793,7 +793,7 @@ class OperationMetadata
         # @!attribute [rw] name
         #   @return [::String]
         #     Revision name. Format:
-        #     `projects/{project}/locations/{location}/deployments/{deployment}/
+        #     `projects/\\{project}/locations/\\{location}/deployments/\\{deployment}/
         #     revisions/\\{revision}`
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]

google-cloud-data_catalog-lineage-v1/proto_docs/google/cloud/datacatalog/lineage/v1/lineage.rb

@@ -800,7 +800,7 @@ class ProcessLinkInfo
           #     location parts of the resource name must match the project and location of
           #     the lineage resource being created. Examples:
           #
-          #     - `{source_type: COMPOSER, name:
+          #     - `\\{source_type: COMPOSER, name:
           #       "projects/foo/locations/us/environments/bar"}`
           #     - `{source_type: BIGQUERY, name: "projects/foo/locations/eu"}`
           #     - `{source_type: CUSTOM,   name: "myCustomIntegration"}`

google-cloud-data_catalog-v1/lib/google/cloud/data_catalog/v1/data_catalog/client.rb

@@ -1338,7 +1338,7 @@ def get_entry request, options = nil
             #     Examples:
             #
             #     * `pubsub.topic.{PROJECT_ID}.{TOPIC_ID}`
-            #     * `pubsub.topic.{PROJECT_ID}.`\``{TOPIC.ID.SEPARATED.WITH.DOTS}`\`
+            #     * `pubsub.topic.{PROJECT_ID}.`\``\\{TOPIC.ID.SEPARATED.WITH.DOTS}`\`
             #     * `bigquery.table.{PROJECT_ID}.{DATASET_ID}.{TABLE_ID}`
             #     * `bigquery.dataset.{PROJECT_ID}.{DATASET_ID}`
             #     * `datacatalog.entry.{PROJECT_ID}.{LOCATION_ID}.{ENTRY_GROUP_ID}.{ENTRY_ID}`

google-cloud-data_catalog-v1/lib/google/cloud/data_catalog/v1/data_catalog/rest/client.rb

@@ -1246,7 +1246,7 @@ def get_entry request, options = nil
               #     Examples:
               #
               #     * `pubsub.topic.{PROJECT_ID}.{TOPIC_ID}`
-              #     * `pubsub.topic.{PROJECT_ID}.`\``{TOPIC.ID.SEPARATED.WITH.DOTS}`\`
+              #     * `pubsub.topic.{PROJECT_ID}.`\``\\{TOPIC.ID.SEPARATED.WITH.DOTS}`\`
               #     * `bigquery.table.{PROJECT_ID}.{DATASET_ID}.{TABLE_ID}`
               #     * `bigquery.dataset.{PROJECT_ID}.{DATASET_ID}`
               #     * `datacatalog.entry.{PROJECT_ID}.{LOCATION_ID}.{ENTRY_GROUP_ID}.{ENTRY_ID}`

google-cloud-data_catalog-v1/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb

@@ -372,7 +372,7 @@ class GetEntryRequest
         #     Examples:
         #
         #     * `pubsub.topic.{PROJECT_ID}.{TOPIC_ID}`
-        #     * `pubsub.topic.{PROJECT_ID}.`\``{TOPIC.ID.SEPARATED.WITH.DOTS}`\`
+        #     * `pubsub.topic.{PROJECT_ID}.`\``\\{TOPIC.ID.SEPARATED.WITH.DOTS}`\`
         #     * `bigquery.table.{PROJECT_ID}.{DATASET_ID}.{TABLE_ID}`
         #     * `bigquery.dataset.{PROJECT_ID}.{DATASET_ID}`
         #     * `datacatalog.entry.{PROJECT_ID}.{LOCATION_ID}.{ENTRY_GROUP_ID}.{ENTRY_ID}`

google-cloud-dataflow-v1beta3/proto_docs/google/dataflow/v1beta3/jobs.rb

@@ -900,7 +900,7 @@ class FailedLocation
         # be a partial response, depending on the page size in the ListJobsRequest.
         # However, if the project does not have any jobs, an instance of
         # ListJobsResponse is not returned and the requests's response
-        # body is empty {}.
+        # body is empty \\{}.
         # @!attribute [rw] jobs
         #   @return [::Array<::Google::Cloud::Dataflow::V1beta3::Job>]
         #     A subset of the requested job information.

google-cloud-dialogflow-cx-v3/proto_docs/google/cloud/dialogflow/cx/v3/agent.rb

@@ -205,7 +205,7 @@ class GithubSettings
             # @!attribute [rw] engine
             #   @return [::String]
             #     Required. The full name of the Gen App Builder engine related to this
-            #     agent if there is one. Format: `projects/{Project ID}/locations/{Location
+            #     agent if there is one. Format: `projects/\\{Project ID}/locations/\\{Location
             #     ID}/collections/\\{Collection ID}/engines/\\{Engine ID}`
             class GenAppBuilderSettings
               include ::Google::Protobuf::MessageExts

google-cloud-dialogflow-v2/proto_docs/google/cloud/dialogflow/v2/agent.rb

@@ -103,7 +103,7 @@ module MatchMode
             MATCH_MODE_HYBRID = 1
 
             # Can be used for agents with a large number of examples in intents,
-            # especially the ones using @sys.any or very large custom entities.
+            # especially the ones using `@sys`.any or very large custom entities.
             MATCH_MODE_ML_ONLY = 2
           end
 

google-cloud-dialogflow-v2/proto_docs/google/cloud/dialogflow/v2/agent_coaching_instruction.rb

@@ -41,7 +41,7 @@ module V2
         # @!attribute [rw] system_action
         #   @return [::String]
         #     Optional. The action that system should take. For example,
-        #     "call GetOrderTime with order_number={order number provided by the
+        #     "call GetOrderTime with order_number=\\{order number provided by the
         #     customer}". If the users don't have plugins or don't want to trigger
         #     plugins, the system_action can be empty
         # @!attribute [r] duplicate_check_result

google-cloud-dialogflow-v2/proto_docs/google/cloud/dialogflow/v2/audio_config.rb

@@ -263,7 +263,7 @@ module PhoneticEncoding
             # https://en.wikipedia.org/wiki/International_Phonetic_Alphabet
             PHONETIC_ENCODING_IPA = 1
 
-            # X-SAMPA, such as apple -> "{p@l".
+            # X-SAMPA, such as apple -> "\\{p@l".
             # https://en.wikipedia.org/wiki/X-SAMPA
             PHONETIC_ENCODING_X_SAMPA = 2
           end

google-cloud-dialogflow-v2/proto_docs/google/cloud/dialogflow/v2/conversation.rb

@@ -605,7 +605,7 @@ class GenerateStatelessSummaryRequest
           #   @return [::Array<::Google::Cloud::Dialogflow::V2::Message>]
           #     Required. The messages that the Summary will be generated from. It is
           #     expected that this message content is already redacted and does not
-          #     contain any PII. Required fields: {content, language_code, participant,
+          #     contain any PII. Required fields: \\{content, language_code, participant,
           #     participant_role} Optional fields: \\{send_time} If send_time is not
           #     provided, then the messages must be provided in chronological order.
           # @!attribute [rw] parent

google-cloud-discovery_engine-v1beta/lib/google/cloud/discovery_engine/v1beta/document_service/client.rb

@@ -841,7 +841,7 @@ def delete_document request, options = nil
             #     the documents.
             #
             #     For {::Google::Cloud::DiscoveryEngine::V1beta::GcsSource GcsSource} it is the
-            #     key of the JSON field. For instance, `my_id` for JSON `{"my_id":
+            #     key of the JSON field. For instance, `my_id` for JSON `\\{"my_id":
             #     "some_uuid"}`. For others, it may be the column name of the table where the
             #     unique ids are stored.
             #

google-cloud-discovery_engine-v1beta/lib/google/cloud/discovery_engine/v1beta/document_service/rest/client.rb

@@ -799,7 +799,7 @@ def delete_document request, options = nil
               #     the documents.
               #
               #     For {::Google::Cloud::DiscoveryEngine::V1beta::GcsSource GcsSource} it is the
-              #     key of the JSON field. For instance, `my_id` for JSON `{"my_id":
+              #     key of the JSON field. For instance, `my_id` for JSON `\\{"my_id":
               #     "some_uuid"}`. For others, it may be the column name of the table where the
               #     unique ids are stored.
               #

google-cloud-discovery_engine-v1beta/proto_docs/google/cloud/discoveryengine/v1beta/assistant.rb

@@ -64,7 +64,7 @@ module V1beta
         #     The values consist of admin enabled tools towards the connector
         #     instance. Admin can selectively enable multiple tools on any of the
         #     connector instances that they created in the project. For example
-        #     {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2,
+        #     \\{"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2,
         #     "transferTicket")],
         #      "gmail1ConnectorName": [(toolId3, "sendEmail"),..] }
         # @!attribute [rw] customer_policy

google-cloud-discovery_engine-v1beta/proto_docs/google/cloud/discoveryengine/v1beta/import_config.rb

@@ -629,7 +629,7 @@ class ImportDocumentsMetadata
         #     the documents.
         #
         #     For {::Google::Cloud::DiscoveryEngine::V1beta::GcsSource GcsSource} it is the
-        #     key of the JSON field. For instance, `my_id` for JSON `{"my_id":
+        #     key of the JSON field. For instance, `my_id` for JSON `\\{"my_id":
         #     "some_uuid"}`. For others, it may be the column name of the table where the
         #     unique ids are stored.
         #

google-cloud-dlp-v2/proto_docs/google/privacy/dlp/v2/dlp.rb

@@ -3008,7 +3008,7 @@ module CommonCharsToIgnore
             # a-z
             ALPHA_LOWER_CASE = 3
 
-            # US Punctuation, one of !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
+            # US Punctuation, one of !"#$%&'()*+,-./:;<=>?@[\]^_`\\{|}~
             PUNCTUATION = 4
 
             # Whitespace character, one of [ \t\n\x0B\f\r]

google-cloud-dlp-v2/proto_docs/google/privacy/dlp/v2/storage.rb

@@ -397,7 +397,7 @@ class DatastoreOptions
         # entire file path (i.e., everything in the url after the bucket name) must
         # match the regular expression.
         #
-        # For example, given the input `{bucket_name: "mybucket", include_regex:
+        # For example, given the input `\\{bucket_name: "mybucket", include_regex:
         # ["directory1/.*"], exclude_regex:
         # ["directory1/excluded.*"]}`:
         #

google-cloud-eventarc-v1/proto_docs/google/cloud/eventarc/v1/enrollment.rb

@@ -66,7 +66,7 @@ module V1
         #   @return [::String]
         #     Required. Destination is the Pipeline that the Enrollment is delivering to.
         #     It must point to the full resource name of a Pipeline. Format:
-        #     "projects/\\{PROJECT_ID}/locations/\\{region}/pipelines/{PIPELINE_ID)"
+        #     "projects/\\{PROJECT_ID}/locations/\\{region}/pipelines/\\{PIPELINE_ID)"
         class Enrollment
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods