google-cloud-firestore 0.24.1 → 0.24.2

data/lib/google/cloud/firestore/v1beta1/doc/google/firestore/v1beta1/query.rb

@@ -32,20 +32,20 @@ module Google
       #
       #     Firestore guarantees a stable ordering through the following rules:
       #
-      #     * Any field required to appear in +order_by+, that is not already
-      #       specified in +order_by+, is appended to the order in field name order
+      #     * Any field required to appear in `order_by`, that is not already
+      #       specified in `order_by`, is appended to the order in field name order
       #       by default.
-      #     * If an order on +__name__+ is not specified, it is appended by default.
+      #     * If an order on `__name__` is not specified, it is appended by default.
       #
       #     Fields are appended with the same sort direction as the last order
       #     specified, or 'ASCENDING' if no order was specified. For example:
       #
-      #     * +SELECT * FROM Foo ORDER BY A+ becomes
-      #       +SELECT * FROM Foo ORDER BY A, __name__+
-      #     * +SELECT * FROM Foo ORDER BY A DESC+ becomes
-      #       +SELECT * FROM Foo ORDER BY A DESC, __name__ DESC+
-      #     * +SELECT * FROM Foo WHERE A > 1+ becomes
-      #       +SELECT * FROM Foo WHERE A > 1 ORDER BY A, __name__+
+      #     * `SELECT * FROM Foo ORDER BY A` becomes
+      #       `SELECT * FROM Foo ORDER BY A, __name__`
+      #     * `SELECT * FROM Foo ORDER BY A DESC` becomes
+      #       `SELECT * FROM Foo ORDER BY A DESC, __name__ DESC`
+      #     * `SELECT * FROM Foo WHERE A > 1` becomes
+      #       `SELECT * FROM Foo WHERE A > 1 ORDER BY A, __name__`
       # @!attribute [rw] start_at
       #   @return [Google::Firestore::V1beta1::Cursor]
       #     A starting point for the query results.
@@ -65,7 +65,7 @@ module Google
       #     Applies after all other constraints.
       #     Must be >= 0 if specified.
       class StructuredQuery
-        # A selection of a collection, such as +messages as m1+.
+        # A selection of a collection, such as `messages as m1`.
         # @!attribute [rw] collection_id
         #   @return [String]
         #     The collection ID.
@@ -73,7 +73,7 @@ module Google
         # @!attribute [rw] all_descendants
         #   @return [true, false]
         #     When false, selects only collections that are immediate children of
-        #     the +parent+ specified in the containing +RunQueryRequest+.
+        #     the `parent` specified in the containing `RunQueryRequest`.
         #     When true, selects all descendant collections.
         class CollectionSelector; end
 
@@ -124,17 +124,17 @@ module Google
             # Unspecified. This value must not be used.
             OPERATOR_UNSPECIFIED = 0
 
-            # Less than. Requires that the field come first in +order_by+.
+            # Less than. Requires that the field come first in `order_by`.
             LESS_THAN = 1
 
-            # Less than or equal. Requires that the field come first in +order_by+.
+            # Less than or equal. Requires that the field come first in `order_by`.
             LESS_THAN_OR_EQUAL = 2
 
-            # Greater than. Requires that the field come first in +order_by+.
+            # Greater than. Requires that the field come first in `order_by`.
             GREATER_THAN = 3
 
             # Greater than or equal. Requires that the field come first in
-            # +order_by+.
+            # `order_by`.
             GREATER_THAN_OR_EQUAL = 4
 
             # Equal.
@@ -172,10 +172,10 @@ module Google
         #     The field to order by.
         # @!attribute [rw] direction
         #   @return [Google::Firestore::V1beta1::StructuredQuery::Direction]
-        #     The direction to order by. Defaults to +ASCENDING+.
+        #     The direction to order by. Defaults to `ASCENDING`.
         class Order; end
 
-        # A reference to a field, such as +max(messages.time) as max_time+.
+        # A reference to a field, such as `max(messages.time) as max_time`.
         # @!attribute [rw] field_path
         #   @return [String]
         class FieldReference; end
@@ -186,7 +186,7 @@ module Google
         #     The fields to return.
         #
         #     If empty, all fields are returned. To only return the name
-        #     of the document, use +['__name__']+.
+        #     of the document, use `['__name__']`.
         class Projection; end
 
         # A sort direction.

data/lib/google/cloud/firestore/v1beta1/doc/google/firestore/v1beta1/write.rb

@@ -23,19 +23,19 @@ module Google
       # @!attribute [rw] delete
       #   @return [String]
       #     A document name to delete. In the format:
-      #     +projects/\\{project_id}/databases/\\{database_id}/documents/\\{document_path}+.
+      #     `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
       # @!attribute [rw] transform
       #   @return [Google::Firestore::V1beta1::DocumentTransform]
       #     Applies a tranformation to a document.
-      #     At most one +transform+ per document is allowed in a given request.
-      #     An +update+ cannot follow a +transform+ on the same document in a given
+      #     At most one `transform` per document is allowed in a given request.
+      #     An `update` cannot follow a `transform` on the same document in a given
       #     request.
       # @!attribute [rw] update_mask
       #   @return [Google::Firestore::V1beta1::DocumentMask]
       #     The fields to update in this write.
       #
-      #     This field can be set only when the operation is +update+.
-      #     If the mask is not set for an +update+ and the document exists, any
+      #     This field can be set only when the operation is `update`.
+      #     If the mask is not set for an `update` and the document exists, any
       #     existing data will be overwritten.
       #     If the mask is set and the document on the server has fields not covered by
       #     the mask, they are left unchanged.
@@ -110,7 +110,7 @@ module Google
       # @!attribute [rw] update_time
       #   @return [Google::Protobuf::Timestamp]
       #     The last update time of the document after applying the write. Not set
-      #     after a +delete+.
+      #     after a `delete`.
       #
       #     If the write did not actually change the document, this will be the
       #     previous update_time.
@@ -131,7 +131,7 @@ module Google
       #   @return [Google::Firestore::V1beta1::Document]
       #     The new state of the {Google::Firestore::V1beta1::Document Document}.
       #
-      #     If +mask+ is set, contains only fields that were updated or added.
+      #     If `mask` is set, contains only fields that were updated or added.
       # @!attribute [rw] target_ids
       #   @return [Array<Integer>]
       #     A set of target IDs of targets that match this document.
@@ -157,7 +157,7 @@ module Google
       #   @return [Google::Protobuf::Timestamp]
       #     The read timestamp at which the delete was observed.
       #
-      #     Greater or equal to the +commit_time+ of the delete.
+      #     Greater or equal to the `commit_time` of the delete.
       class DocumentDelete; end
 
       # A {Google::Firestore::V1beta1::Document Document} has been removed from the view of the targets.
@@ -178,7 +178,7 @@ module Google
       #   @return [Google::Protobuf::Timestamp]
       #     The read timestamp at which the remove was observed.
       #
-      #     Greater or equal to the +commit_time+ of the change/delete/remove.
+      #     Greater or equal to the `commit_time` of the change/delete/remove.
       class DocumentRemove; end
 
       # A digest of all the documents that match a given target.

data/lib/google/cloud/firestore/v1beta1/doc/google/protobuf/any.rb

@@ -15,7 +15,7 @@
 
 module Google
   module Protobuf
-    # +Any+ contains an arbitrary serialized protocol buffer message along with a
+    # `Any` contains an arbitrary serialized protocol buffer message along with a
     # URL that describes the type of the serialized message.
     #
     # Protobuf library provides support to pack/unpack Any values in the form
@@ -69,9 +69,9 @@ module Google
     #
     # = JSON
     #
-    # The JSON representation of an +Any+ value uses the regular
+    # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
-    # additional field +@type+ which contains the type URL. Example:
+    # additional field `@type` which contains the type URL. Example:
     #
     #     package google.profile;
     #     message Person {
@@ -87,7 +87,7 @@ module Google
     #
     # If the embedded message type is well-known and has a custom JSON
     # representation, that representation will be embedded adding a field
-    # +value+ which holds the custom JSON in addition to the +@type+
+    # `value` which holds the custom JSON in addition to the `@type`
     # field. Example (for message {Google::Protobuf::Duration}):
     #
     #     {
@@ -99,15 +99,15 @@ module Google
     #     A URL/resource name that uniquely identifies the type of the serialized
     #     protocol buffer message. The last segment of the URL's path must represent
     #     the fully qualified name of the type (as in
-    #     +path/google.protobuf.Duration+). The name should be in a canonical form
+    #     `path/google.protobuf.Duration`). The name should be in a canonical form
     #     (e.g., leading "." is not accepted).
     #
     #     In practice, teams usually precompile into the binary all types that they
     #     expect it to use in the context of Any. However, for URLs which use the
-    #     scheme +http+, +https+, or no scheme, one can optionally set up a type
+    #     scheme `http`, `https`, or no scheme, one can optionally set up a type
     #     server that maps type URLs to message definitions as follows:
     #
-    #     * If no scheme is provided, +https+ is assumed.
+    #     * If no scheme is provided, `https` is assumed.
     #     * An HTTP GET on the URL must yield a {Google::Protobuf::Type}
     #       value in binary format, or produce an error.
     #     * Applications are allowed to cache lookup results based on the
@@ -120,7 +120,7 @@ module Google
     #     protobuf release, and it is not used for type URLs beginning with
     #     type.googleapis.com.
     #
-    #     Schemes other than +http+, +https+ (or the empty scheme) might be
+    #     Schemes other than `http`, `https` (or the empty scheme) might be
     #     used with implementation specific semantics.
     # @!attribute [rw] value
     #   @return [String]

data/lib/google/cloud/firestore/v1beta1/doc/google/protobuf/empty.rb

@@ -23,7 +23,7 @@ module Google
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
     #
-    # The JSON representation for +Empty+ is empty JSON object +{}+.
+    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty; end
   end
 end

data/lib/google/cloud/firestore/v1beta1/doc/google/protobuf/timestamp.rb

@@ -29,13 +29,13 @@ module Google
     #
     # = Examples
     #
-    # Example 1: Compute Timestamp from POSIX +time()+.
+    # Example 1: Compute Timestamp from POSIX `time()`.
     #
     #     Timestamp timestamp;
     #     timestamp.set_seconds(time(NULL));
     #     timestamp.set_nanos(0);
     #
-    # Example 2: Compute Timestamp from POSIX +gettimeofday()+.
+    # Example 2: Compute Timestamp from POSIX `gettimeofday()`.
     #
     #     struct timeval tv;
     #     gettimeofday(&tv, NULL);
@@ -44,7 +44,7 @@ module Google
     #     timestamp.set_seconds(tv.tv_sec);
     #     timestamp.set_nanos(tv.tv_usec * 1000);
     #
-    # Example 3: Compute Timestamp from Win32 +GetSystemTimeAsFileTime()+.
+    # Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
     #
     #     FILETIME ft;
     #     GetSystemTimeAsFileTime(&ft);
@@ -56,7 +56,7 @@ module Google
     #     timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
     #     timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
     #
-    # Example 4: Compute Timestamp from Java +System.currentTimeMillis()+.
+    # Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
     #
     #     long millis = System.currentTimeMillis();
     #
@@ -87,10 +87,10 @@ module Google
     #
     # In JavaScript, one can convert a Date object to this format using the
     # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
-    # method. In Python, a standard +datetime.datetime+ object can be converted
-    # to this format using [+strftime+](https://docs.python.org/2/library/time.html#time.strftime)
+    # method. In Python, a standard `datetime.datetime` object can be converted
+    # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
     # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
-    # can use the Joda Time's [+ISODateTimeFormat.dateTime()+](
+    # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
     # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds

data/lib/google/cloud/firestore/v1beta1/doc/google/protobuf/wrappers.rb

@@ -15,73 +15,73 @@
 
 module Google
   module Protobuf
-    # Wrapper message for +double+.
+    # Wrapper message for `double`.
     #
-    # The JSON representation for +DoubleValue+ is JSON number.
+    # The JSON representation for `DoubleValue` is JSON number.
     # @!attribute [rw] value
     #   @return [Float]
     #     The double value.
     class DoubleValue; end
 
-    # Wrapper message for +float+.
+    # Wrapper message for `float`.
     #
-    # The JSON representation for +FloatValue+ is JSON number.
+    # The JSON representation for `FloatValue` is JSON number.
     # @!attribute [rw] value
     #   @return [Float]
     #     The float value.
     class FloatValue; end
 
-    # Wrapper message for +int64+.
+    # Wrapper message for `int64`.
     #
-    # The JSON representation for +Int64Value+ is JSON string.
+    # The JSON representation for `Int64Value` is JSON string.
     # @!attribute [rw] value
     #   @return [Integer]
     #     The int64 value.
     class Int64Value; end
 
-    # Wrapper message for +uint64+.
+    # Wrapper message for `uint64`.
     #
-    # The JSON representation for +UInt64Value+ is JSON string.
+    # The JSON representation for `UInt64Value` is JSON string.
     # @!attribute [rw] value
     #   @return [Integer]
     #     The uint64 value.
     class UInt64Value; end
 
-    # Wrapper message for +int32+.
+    # Wrapper message for `int32`.
     #
-    # The JSON representation for +Int32Value+ is JSON number.
+    # The JSON representation for `Int32Value` is JSON number.
     # @!attribute [rw] value
     #   @return [Integer]
     #     The int32 value.
     class Int32Value; end
 
-    # Wrapper message for +uint32+.
+    # Wrapper message for `uint32`.
     #
-    # The JSON representation for +UInt32Value+ is JSON number.
+    # The JSON representation for `UInt32Value` is JSON number.
     # @!attribute [rw] value
     #   @return [Integer]
     #     The uint32 value.
     class UInt32Value; end
 
-    # Wrapper message for +bool+.
+    # Wrapper message for `bool`.
     #
-    # The JSON representation for +BoolValue+ is JSON +true+ and +false+.
+    # The JSON representation for `BoolValue` is JSON `true` and `false`.
     # @!attribute [rw] value
     #   @return [true, false]
     #     The bool value.
     class BoolValue; end
 
-    # Wrapper message for +string+.
+    # Wrapper message for `string`.
     #
-    # The JSON representation for +StringValue+ is JSON string.
+    # The JSON representation for `StringValue` is JSON string.
     # @!attribute [rw] value
     #   @return [String]
     #     The string value.
     class StringValue; end
 
-    # Wrapper message for +bytes+.
+    # Wrapper message for `bytes`.
     #
-    # The JSON representation for +BytesValue+ is JSON string.
+    # The JSON representation for `BytesValue` is JSON string.
     # @!attribute [rw] value
     #   @return [String]
     #     The bytes value.

data/lib/google/cloud/firestore/v1beta1/doc/google/rpc/status.rb

@@ -15,7 +15,7 @@
 
 module Google
   module Rpc
-    # The +Status+ type defines a logical error model that is suitable for different
+    # The `Status` type defines a logical error model that is suitable for different
     # programming environments, including REST APIs and RPC APIs. It is used by
     # [gRPC](https://github.com/grpc). The error model is designed to be:
     #
@@ -24,7 +24,7 @@ module Google
     #
     # = Overview
     #
-    # The +Status+ message contains three pieces of data: error code, error message,
+    # The `Status` message contains three pieces of data: error code, error message,
     # and error details. The error code should be an enum value of
     # {Google::Rpc::Code}, but it may accept additional error codes if needed.  The
     # error message should be a developer-facing English message that helps
@@ -32,40 +32,40 @@ module Google
     # error message is needed, put the localized message in the error details or
     # localize it in the client. The optional error details may contain arbitrary
     # information about the error. There is a predefined set of error detail types
-    # in the package +google.rpc+ that can be used for common error conditions.
+    # in the package `google.rpc` that can be used for common error conditions.
     #
     # = Language mapping
     #
-    # The +Status+ message is the logical representation of the error model, but it
-    # is not necessarily the actual wire format. When the +Status+ message is
+    # The `Status` message is the logical representation of the error model, but it
+    # is not necessarily the actual wire format. When the `Status` message is
     # exposed in different client libraries and different wire protocols, it can be
     # mapped differently. For example, it will likely be mapped to some exceptions
     # in Java, but more likely mapped to some error codes in C.
     #
     # = Other uses
     #
-    # The error model and the +Status+ message can be used in a variety of
+    # The error model and the `Status` message can be used in a variety of
     # environments, either with or without APIs, to provide a
     # consistent developer experience across different environments.
     #
     # Example uses of this error model include:
     #
     # * Partial errors. If a service needs to return partial errors to the client,
-    #   it may embed the +Status+ in the normal response to indicate the partial
+    #   it may embed the `Status` in the normal response to indicate the partial
     #   errors.
     #
     # * Workflow errors. A typical workflow has multiple steps. Each step may
-    #   have a +Status+ message for error reporting.
+    #   have a `Status` message for error reporting.
     #
     # * Batch operations. If a client uses batch request and batch response, the
-    #   +Status+ message should be used directly inside batch response, one for
+    #   `Status` message should be used directly inside batch response, one for
     #   each error sub-response.
     #
     # * Asynchronous operations. If an API call embeds asynchronous operation
     #   results in its response, the status of those operations should be
-    #   represented directly using the +Status+ message.
+    #   represented directly using the `Status` message.
     #
-    # * Logging. If some API errors are stored in logs, the message +Status+ could
+    # * Logging. If some API errors are stored in logs, the message `Status` could
     #   be used directly after any stripping needed for security/privacy reasons.
     # @!attribute [rw] code
     #   @return [Integer]

data/lib/google/cloud/firestore/v1beta1/firestore_client.rb

@@ -36,17 +36,17 @@ module Google
         #
         # This service exposes several types of comparable timestamps:
         #
-        # * +create_time+ - The time at which a document was created. Changes only
+        # * `create_time` - The time at which a document was created. Changes only
         #   when a document is deleted, then re-created. Increases in a strict
         #   monotonic fashion.
-        # * +update_time+ - The time at which a document was last updated. Changes
+        # * `update_time` - The time at which a document was last updated. Changes
         #   every time a document is modified. Does not change when a write results
         #   in no modifications. Increases in a strict monotonic fashion.
-        # * +read_time+ - The time at which a particular state was observed. Used
+        # * `read_time` - The time at which a particular state was observed. Used
         #   to denote a consistent snapshot of the database or the time at which a
         #   Document was observed to not exist.
-        # * +commit_time+ - The time at which the writes in a transaction were
-        #   committed. Any read with an equal or greater +read_time+ is guaranteed
+        # * `commit_time` - The time at which the writes in a transaction were
+        #   committed. Any read with an equal or greater `read_time` is guaranteed
         #   to see the effects of the transaction.
         #
         # @!attribute [r] firestore_stub
@@ -337,7 +337,7 @@ module Google
           #
           # @param name [String]
           #   The resource name of the Document to get. In the format:
-          #   +projects/\\{project_id}/databases/\\{database_id}/documents/\\{document_path}+.
+          #   `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
           # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
           #   The fields to return. If not set, returns all fields.
           #
@@ -388,14 +388,14 @@ module Google
           #
           # @param parent [String]
           #   The parent resource name. In the format:
-          #   +projects/\\{project_id}/databases/\\{database_id}/documents+ or
-          #   +projects/\\{project_id}/databases/\\{database_id}/documents/\\{document_path}+.
+          #   `projects/{project_id}/databases/{database_id}/documents` or
+          #   `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
           #   For example:
-          #   +projects/my-project/databases/my-database/documents+ or
-          #   +projects/my-project/databases/my-database/documents/chatrooms/my-chatroom+
+          #   `projects/my-project/databases/my-database/documents` or
+          #   `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
           # @param collection_id [String]
-          #   The collection ID, relative to +parent+, to list. For example: +chatrooms+
-          #   or +messages+.
+          #   The collection ID, relative to `parent`, to list. For example: `chatrooms`
+          #   or `messages`.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -403,7 +403,7 @@ module Google
           #   performed per-page, this determines the maximum number of
           #   resources in a page.
           # @param order_by [String]
-          #   The order to sort results by. For example: +priority desc, name+.
+          #   The order to sort results by. For example: `priority desc, name`.
           # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
           #   The fields to return. If not set, returns all fields.
           #
@@ -424,8 +424,8 @@ module Google
           #   be returned with a key but will not have fields, {Google::Firestore::V1beta1::Document#create_time Document#create_time},
           #   or {Google::Firestore::V1beta1::Document#update_time Document#update_time} set.
           #
-          #   Requests with +show_missing+ may not specify +where+ or
-          #   +order_by+.
+          #   Requests with `show_missing` may not specify `where` or
+          #   `order_by`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -444,7 +444,7 @@ module Google
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
           #   formatted_parent = Google::Cloud::Firestore::V1beta1::FirestoreClient.any_path_path("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]")
           #
-          #   # TODO: Initialize +collection_id+:
+          #   # TODO: Initialize `collection_id`:
           #   collection_id = ''
           #
           #   # Iterate over all results.
@@ -489,16 +489,16 @@ module Google
           #
           # @param parent [String]
           #   The parent resource. For example:
-          #   +projects/\\{project_id}/databases/\\{database_id}/documents+ or
-          #   +projects/\\{project_id}/databases/\\{database_id}/documents/chatrooms/\\{chatroom_id}+
+          #   `projects/{project_id}/databases/{database_id}/documents` or
+          #   `projects/{project_id}/databases/{database_id}/documents/chatrooms/{chatroom_id}`
           # @param collection_id [String]
-          #   The collection ID, relative to +parent+, to list. For example: +chatrooms+.
+          #   The collection ID, relative to `parent`, to list. For example: `chatrooms`.
           # @param document_id [String]
           #   The client-assigned document ID to use for this document.
           #
           #   Optional. If not specified, an ID will be assigned by the service.
           # @param document [Google::Firestore::V1beta1::Document | Hash]
-          #   The document to create. +name+ must not be set.
+          #   The document to create. `name` must not be set.
           #   A hash of the same form as `Google::Firestore::V1beta1::Document`
           #   can also be provided.
           # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
@@ -522,13 +522,13 @@ module Google
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
           #   formatted_parent = Google::Cloud::Firestore::V1beta1::FirestoreClient.any_path_path("[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]")
           #
-          #   # TODO: Initialize +collection_id+:
+          #   # TODO: Initialize `collection_id`:
           #   collection_id = ''
           #
-          #   # TODO: Initialize +document_id+:
+          #   # TODO: Initialize `document_id`:
           #   document_id = ''
           #
-          #   # TODO: Initialize +document+:
+          #   # TODO: Initialize `document`:
           #   document = {}
           #   response = firestore_client.create_document(formatted_parent, collection_id, document_id, document)
 
@@ -593,10 +593,10 @@ module Google
           #
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
           #
-          #   # TODO: Initialize +document+:
+          #   # TODO: Initialize `document`:
           #   document = {}
           #
-          #   # TODO: Initialize +update_mask+:
+          #   # TODO: Initialize `update_mask`:
           #   update_mask = {}
           #   response = firestore_client.update_document(document, update_mask)
 
@@ -621,7 +621,7 @@ module Google
           #
           # @param name [String]
           #   The resource name of the Document to delete. In the format:
-          #   +projects/\\{project_id}/databases/\\{database_id}/documents/\\{document_path}+.
+          #   `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
           # @param current_document [Google::Firestore::V1beta1::Precondition | Hash]
           #   An optional precondition on the document.
           #   The request will fail if this is set and not met by the target document.
@@ -662,12 +662,12 @@ module Google
           #
           # @param database [String]
           #   The database name. In the format:
-          #   +projects/\\{project_id}/databases/\\{database_id}+.
+          #   `projects/{project_id}/databases/{database_id}`.
           # @param documents [Array<String>]
           #   The names of the documents to retrieve. In the format:
-          #   +projects/\\{project_id}/databases/\\{database_id}/documents/\\{document_path}+.
+          #   `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
           #   The request will fail if any of the document is not a child resource of the
-          #   given +database+. Duplicate names will be elided.
+          #   given `database`. Duplicate names will be elided.
           # @param mask [Google::Firestore::V1beta1::DocumentMask | Hash]
           #   The fields to return. If not set, returns all fields.
           #
@@ -702,7 +702,7 @@ module Google
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
           #   formatted_database = Google::Cloud::Firestore::V1beta1::FirestoreClient.database_root_path("[PROJECT]", "[DATABASE]")
           #
-          #   # TODO: Initialize +documents+:
+          #   # TODO: Initialize `documents`:
           #   documents = []
           #   firestore_client.batch_get_documents(formatted_database, documents).each do |element|
           #     # Process element.
@@ -732,7 +732,7 @@ module Google
           #
           # @param database [String]
           #   The database name. In the format:
-          #   +projects/\\{project_id}/databases/\\{database_id}+.
+          #   `projects/{project_id}/databases/{database_id}`.
           # @param options_ [Google::Firestore::V1beta1::TransactionOptions | Hash]
           #   The options for the transaction.
           #   Defaults to a read-write transaction.
@@ -770,7 +770,7 @@ module Google
           #
           # @param database [String]
           #   The database name. In the format:
-          #   +projects/\\{project_id}/databases/\\{database_id}+.
+          #   `projects/{project_id}/databases/{database_id}`.
           # @param writes [Array<Google::Firestore::V1beta1::Write | Hash>]
           #   The writes to apply.
           #
@@ -793,7 +793,7 @@ module Google
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
           #   formatted_database = Google::Cloud::Firestore::V1beta1::FirestoreClient.database_root_path("[PROJECT]", "[DATABASE]")
           #
-          #   # TODO: Initialize +writes+:
+          #   # TODO: Initialize `writes`:
           #   writes = []
           #   response = firestore_client.commit(formatted_database, writes)
 
@@ -816,7 +816,7 @@ module Google
           #
           # @param database [String]
           #   The database name. In the format:
-          #   +projects/\\{project_id}/databases/\\{database_id}+.
+          #   `projects/{project_id}/databases/{database_id}`.
           # @param transaction [String]
           #   The transaction to roll back.
           # @param options [Google::Gax::CallOptions]
@@ -832,7 +832,7 @@ module Google
           #   firestore_client = Google::Cloud::Firestore::V1beta1.new
           #   formatted_database = Google::Cloud::Firestore::V1beta1::FirestoreClient.database_root_path("[PROJECT]", "[DATABASE]")
           #
-          #   # TODO: Initialize +transaction+:
+          #   # TODO: Initialize `transaction`:
           #   transaction = ''
           #   firestore_client.rollback(formatted_database, transaction)
 
@@ -854,11 +854,11 @@ module Google
           #
           # @param parent [String]
           #   The parent resource name. In the format:
-          #   +projects/\\{project_id}/databases/\\{database_id}/documents+ or
-          #   +projects/\\{project_id}/databases/\\{database_id}/documents/\\{document_path}+.
+          #   `projects/{project_id}/databases/{database_id}/documents` or
+          #   `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
           #   For example:
-          #   +projects/my-project/databases/my-database/documents+ or
-          #   +projects/my-project/databases/my-database/documents/chatrooms/my-chatroom+
+          #   `projects/my-project/databases/my-database/documents` or
+          #   `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
           # @param structured_query [Google::Firestore::V1beta1::StructuredQuery | Hash]
           #   A structured query.
           #   A hash of the same form as `Google::Firestore::V1beta1::StructuredQuery`
@@ -985,9 +985,9 @@ module Google
           #
           # @param parent [String]
           #   The parent document. In the format:
-          #   +projects/\\{project_id}/databases/\\{database_id}/documents/\\{document_path}+.
+          #   `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
           #   For example:
-          #   +projects/my-project/databases/my-database/documents/chatrooms/my-chatroom+
+          #   `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this