@@ -1076,7 +1076,9 @@ class Documentation
10761076 # @return [String]
10771077 attr_accessor :service_root_url
10781078
1079- # A short summary of what the service does. Can only be provided by plain text.
1079+ # A short description of what the service does. The summary must be plain text.
1080+ # It becomes the overview of the service displayed in Google Cloud Console. NOTE:
1081+ # This field is equivalent to the standard field `description`.
10801082 # Corresponds to the JSON property `summary`
10811083 # @return [String]
10821084 attr_accessor :summary
@@ -1106,17 +1108,19 @@ class DocumentationRule
11061108 # @return [String]
11071109 attr_accessor :deprecation_description
11081110
1109- # Description of the selected API(s).
1111+ # The description is the comment in front of the selected proto element, such as
1112+ # a message, a method, a 'service' definition, or a field.
11101113 # Corresponds to the JSON property `description`
11111114 # @return [String]
11121115 attr_accessor :description
11131116
1114- # The selector is a comma-separated list of patterns. Each pattern is a
1115- # qualified name of the element which may end in "*", indicating a wildcard.
1116- # Wildcards are only allowed at the end and for a whole component of the
1117- # qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
1118- # wildcard will match one or more components. To specify a default for all
1119- # applicable elements, the whole pattern "*" is used.
1117+ # The selector is a comma-separated list of patterns for any element such as a
1118+ # method, a field, an enum value. Each pattern is a qualified name of the
1119+ # element which may end in "*", indicating a wildcard. Wildcards are only
1120+ # allowed at the end and for a whole component of the qualified name, i.e. "foo.*
1121+ # " is ok, but not "foo.b*" or "foo.*.bar". A wildcard will match one or more
1122+ # components. To specify a default for all applicable elements, the whole
1123+ # pattern "*" is used.
11201124 # Corresponds to the JSON property `selector`
11211125 # @return [String]
11221126 attr_accessor :selector
@@ -2766,7 +2770,8 @@ class Page
27662770 include Google ::Apis ::Core ::Hashable
27672771
27682772 # The Markdown content of the page. You can use (== include `path` ==) to
2769- # include content from a Markdown file.
2773+ # include content from a Markdown file. The content can be used to produce the
2774+ # documentation page such as HTML format page.
27702775 # Corresponds to the JSON property `content`
27712776 # @return [String]
27722777 attr_accessor :content
@@ -3287,8 +3292,8 @@ class Service
32873292
32883293 # A list of all enum types included in this API service. Enums referenced
32893294 # directly or indirectly by the `apis` are automatically included. Enums which
3290- # are not referenced but shall be included should be listed here by name.
3291- # Example: enums: - name: google.someapi.v1.SomeEnum
3295+ # are not referenced but shall be included should be listed here by name by the
3296+ # configuration author. Example: enums: - name: google.someapi.v1.SomeEnum
32923297 # Corresponds to the JSON property `enums`
32933298 # @return [Array<Google::Apis::ServicemanagementV1::Enum>]
32943299 attr_accessor :enums
@@ -3421,16 +3426,17 @@ class Service
34213426 # @return [Array<Google::Apis::ServicemanagementV1::Type>]
34223427 attr_accessor :system_types
34233428
3424- # The product title for this service.
3429+ # The product title for this service, it is the name displayed in Google Cloud
3430+ # Console.
34253431 # Corresponds to the JSON property `title`
34263432 # @return [String]
34273433 attr_accessor :title
34283434
34293435 # A list of all proto message types included in this API service. Types
34303436 # referenced directly or indirectly by the `apis` are automatically included.
34313437 # Messages which are not referenced but shall be included, such as types used by
3432- # the `google.protobuf.Any` type, should be listed here by name. Example: types:
3433- # - name: google.protobuf.Int32
3438+ # the `google.protobuf.Any` type, should be listed here by name by the
3439+ # configuration author. Example: types: - name: google.protobuf.Int32
34343440 # Corresponds to the JSON property `types`
34353441 # @return [Array<Google::Apis::ServicemanagementV1::Type>]
34363442 attr_accessor :types
0 commit comments