google-cloud-bigtable 0.1.3 → 0.2.0

data/lib/google/cloud/bigtable/instance/cluster_map.rb

@@ -19,8 +19,8 @@ module Google
   module Cloud
     module Bigtable
       class Instance
-        # Instance::ClusterMap is a Hash with cluster name and gRPC object.
-        # It is used to create instance.
+        # Instance::ClusterMap is a hash with cluster name and gRPC object.
+        # It is used to create an instance.
         # @example Create
         #
         #  clusters = Google::Cloud::Bigtable::Instance::ClusterMap.new
@@ -33,20 +33,20 @@ module Google
         class ClusterMap < DelegateClass(::Hash)
           # @private
           #
-          # Create a new Instance::ClusterMap with an hash of Cluster name and
+          # Creates a new Instance::ClusterMap with an hash of Cluster name and
           # cluster grpc instances.
           def initialize value = {}
             super(value)
           end
 
-          # Add cluster to map
+          # Adds a cluster to a map
           #
           # @param name [String] Cluster name
           # @param location [String]
           #   The location where this cluster's nodes and storage reside. For best
           #   performance, clients should be located as close as possible to this
           #   cluster. Currently only zones are supported.
-          # @param nodes [Integer] No of nodes
+          # @param nodes [Integer] Number of nodes
           # @param storage_type [Symbol]
           #   Valid values are:
           #   * `:SSD`(Flash (SSD) storage should be used),

data/lib/google/cloud/bigtable/instance/list.rb

@@ -21,14 +21,14 @@ module Google
   module Cloud
     module Bigtable
       class Instance
-        # Instance::List is a special case Array with additional
-        # values and failed_locations
+        # Instance::List is a special-case array with additional
+        # values and failed_locations.
         class List < DelegateClass(::Array)
           # @private
           # The gRPC Service object.
           attr_accessor :service
 
-          # If not empty, indicates that there are more records that match
+          # If not empty, indicates that more records match
           # the request and this value should be passed to continue.
           attr_accessor :token
 
@@ -40,7 +40,7 @@ module Google
           attr_accessor :failed_locations
 
           # @private
-          # Create a new Instance::List with an array of
+          # Creates a new Instance::List with an array of
           # Instance instances.
           def initialize arr = []
             super(arr)
@@ -63,7 +63,7 @@ module Google
             !token.nil?
           end
 
-          # Retrieve the next page of instances.
+          # Retrieves the next page of instances.
           #
           # @return [Instance::List] The list of instances.
           #
@@ -92,11 +92,11 @@ module Google
           # {#next?} returns `false`. Calls the given block once for each
           # result, which is passed as the argument to the block.
           #
-          # An Enumerator is returned if no block is given.
+          # An enumerator is returned if no block is given.
           #
           # This method will make repeated API calls until all remaining results
-          # are retrieved. (Unlike `#each`, for example, which merely iterates
-          # over the results returned by a single API call.) Use with caution.
+          # are retrieved (unlike `#each`, for example, which merely iterates
+          # over the results returned by a single API call). Use with caution.
           #
           # @yield [instance] The block for accessing each instance.
           # @yieldparam [Instance] instance The instance object.
@@ -148,7 +148,7 @@ module Google
 
           protected
 
-          # Raise an error unless an active service is available.
+          # Raises an error unless an active service is available.
           def ensure_service!
             raise "Must have active connection" unless service
           end

data/lib/google/cloud/bigtable/longrunning_job.rb

@@ -63,7 +63,7 @@ module Google
         end
 
         ##
-        # The status if the operation associated with this job produced an
+        # The status when the operation associated with this job produced an
         # error.
         #
         # @return [Object, Google::Rpc::Status, nil] A status object with

data/lib/google/cloud/bigtable/mutation_entry.rb

@@ -20,14 +20,14 @@ module Google
     module Bigtable
       # # MutationEntry
       #
-      # MutationEntry is a chainable structure, which holds data for diffrent
+      # MutationEntry is a chainable structure that holds data for different
       # type of mutations.
-      # MutationEntry is used in following data operations
+      # MutationEntry is used in following data operations:
       #
       #   * Mutate row. See {Google::Cloud::Bigtable::Table#mutate_row}
       #   * Mutate rows. See {Google::Cloud::Bigtable::Table#mutate_rows}
       #   * Check and mutate row using a predicate.
-      #     see {Google::Cloud::Bigtable::Table#check_and_mutate_row}
+      #     See {Google::Cloud::Bigtable::Table#check_and_mutate_row}
       #
       # @example
       #   entry = Google::Cloud::Bigtable::MutationEntry.new("user-1")
@@ -69,14 +69,14 @@ module Google
 
         # Add SetCell mutation to list of mutations.
         #
-        # A Mutation which sets the value of the specified cell.
+        # A mutation that sets the value of the specified cell.
         #
         # @param family [String] Table column family name.
         #   The name of the family into which new data should be written.
         #   Must match `[-_.a-zA-Z0-9]+`
         # @param qualifier [String] Column qualifier name.
         #   The qualifier of the column into which new data should be written.
-        #   Can be any byte string, including the empty string.
+        #   Can be any byte string, including an empty string.
         # @param value [String, Integer] Cell value data.
         #   The value to be written into the specified cell.
         # @param timestamp [Time, Integer] Timestamp value.
@@ -84,7 +84,7 @@ module Google
         #   Use -1 for current Bigtable server time.
         #   Otherwise, the client should set this value itself, noting that the
         #   default value is a timestamp of zero if the field is left unspecified.
-        #   Values must match the granularity of the table (e.g. micros, millis).
+        #   Values must match the granularity of the table (micros or millis, for example).
         # @return [MutationEntry]  `self` object of entry for chaining.
         #
         # @example
@@ -101,7 +101,7 @@ module Google
         #   )
         #
         def set_cell family, qualifier, value, timestamp: nil
-          # If value is integer then covert it to sign 64 bit int big-endian.
+          # If value is integer, covert it to a 64-bit signed big-endian integer.
           value = [value].pack("q>") if value.is_a?(Integer)
           options = {
             family_name: family,
@@ -119,19 +119,19 @@ module Google
 
         # Add DeleteFromColumn entry to list of mutations.
         #
-        # A Mutation which deletes cells from the specified column, optionally
+        # A mutation that deletes cells from the specified column, optionally
         # restricting the deletions to a given timestamp range.
         #
         # @param family [String] Table column family name.
-        #   The name of the family from which cells should be deleted.
+        #   The name of the column family from which cells should be deleted.
         #   Must match `[-_.a-zA-Z0-9]+`
         # @param qualifier [String] Column qualifier name.
         #   The qualifier of the column from which cells should be deleted.
-        #   Can be any byte string, including the empty string.
-        # @param timestamp_from [Integer] Timestamp lower bound. Optional.
-        #   The range of timestamps within which cells should be deleted.
-        # @param timestamp_to [Integer] Timestamp upper bound. Optional.
-        #   The range of timestamps within which cells should be deleted.
+        #   Can be any byte string, including an empty string.
+        # @param timestamp_from [Integer] Timestamp lower boundary. Optional.
+        #   The range of timestamps from which cells should be deleted.
+        # @param timestamp_to [Integer] Timestamp upper boundary. Optional.
+        #   The range of timestamps from which cells should be deleted.
         # @return [MutationEntry] `self` object of entry for chaining.
         #
         # @example Without timestamp range
@@ -146,7 +146,7 @@ module Google
         #     timestamp_from: (Time.now.to_i - 1800) * 1000,
         #     timestamp_to: (Time.now.to_i * 1000)
         #   )
-        # @example With lower bound timestamp range
+        # @example With timestamp range with lower boundary only
         #   entry = Google::Cloud::Bigtable::MutationEntry.new("user-1")
         #   entry.delete_cells(
         #     "cf1",
@@ -177,10 +177,10 @@ module Google
 
         # Add DeleteFromFamily to list of mutations.
         #
-        # A Mutation which deletes all cells from the specified column family.
+        # A mutation that deletes all cells from the specified column family.
         #
         # @param family [String] Table column family name.
-        #   The name of the family from which cells should be deleted.
+        #   The name of the column family from which cells should be deleted.
         #   Must match `[-_.a-zA-Z0-9]+`
         # @return [MutationEntry] `self` object of entry for chaining.
         #
@@ -218,7 +218,7 @@ module Google
           @retryable
         end
 
-        # No of mutations
+        # Number of mutations
         #
         # @return [Integer]
 

data/lib/google/cloud/bigtable/mutation_operations.rb

@@ -25,7 +25,7 @@ module Google
     module Bigtable
       # # MutationOperations
       #
-      # Collection of mutations apis.
+      # Collection of mutations APIs.
       #
       #   * Mutate single row
       #   * Mutate multiple rows
@@ -35,11 +35,11 @@ module Google
       module MutationOperations
         # Mutate row.
         #
-        # Mutates a row atomically. Cells already present in the row are left
+        # Mutates a row atomically. Cells in the row are left
         # unchanged unless explicitly changed by +mutation+.
         # Changes to be atomically applied to the specified row. Entries are applied
-        # in order, meaning that earlier mutations can be masked by later ones.
-        # Must contain at least one mutation entry and at most 100000.
+        # in order, meaning that earlier mutations can be masked by later mutations.
+        # Must contain at least one mutation entry and at most 100,000.
         #
         # @param entry [Google::Cloud::Bigtable::MutationEntry]
         #   Mutation entry with row key and list of mutations.
@@ -91,7 +91,7 @@ module Google
         #   Each entry is applied as an atomic mutation, but the entries may be
         #   applied in arbitrary order (even between entries for the same row).
         #   At least one entry must be specified, and in total the entries can
-        #   contain at most 100000 mutations.
+        #   contain a maximum of 100,000 mutations.
         # @return [Array<Google::Bigtable::V2::MutateRowsResponse::Entry>]
         #
         # @example
@@ -117,7 +117,7 @@ module Google
         # time. The method returns the new contents of all modified cells.
         #
         # @param key [String]
-        #   The key of the row to which the read/modify/write rules should be applied.
+        #   The row key of the row to which the read/modify/write rules should be applied.
         # @param rules [Google::Cloud::Bigtable::ReadModifyWriteRule, Array<Google::Cloud::Bigtable::ReadModifyWriteRule>]
         #   Rules specifying how the specified row's contents are to be transformed
         #   into writes. Entries are applied in order, meaning that earlier rules will
@@ -177,29 +177,31 @@ module Google
           row
         end
 
-        # Mutates a row atomically based on the output of a predicate Reader filter.
+        # Mutates a row atomically based on the output of a predicate reader filter.
         #
         # NOTE: Condition predicate filter is not supported.
         #
         # @param key [String] Row key.
-        #   The key of the row to which the conditional mutation should be applied.
+        #   The row key of the row to which the conditional mutation should be applied.
         # @param predicate [SimpleFilter, ChainFilter, InterleaveFilter] Predicate filter.
         #   The filter to be applied to the contents of the specified row. Depending
         #   on whether or not any results are yielded, either +true_mutations+ or
         #   +false_mutations+ will be executed. If unset, checks that the row contains
-        #   any values at all.
-        # @param on_match [Google::Cloud::Bigtable::MutationEntry] Mutation entry apply on predicate filter match.
+        #   any values.
+        # @param on_match [Google::Cloud::Bigtable::MutationEntry] Mutation entry
+        #   applied to predicate filter match.
         #   Changes to be atomically applied to the specified row if +predicate_filter+
         #   yields at least one cell when applied to +row_key+. Entries are applied in
         #   order, meaning that earlier mutations can be masked by later ones.
-        #   Must contain at least one entry if +false_mutations+ is empty, and at most
-        #   100000.
-        # @param otherwise [Google::Cloud::Bigtable::MutationEntry] Mutation entry apply on predicate filter do not match.
+        #   Must contain at least one entry if +false_mutations+ is empty and at most
+        #   100,000 entries.
+        # @param otherwise [Google::Cloud::Bigtable::MutationEntry] Mutation entry applied
+        #   when predicate filter does not match.
         #   Changes to be atomically applied to the specified row if +predicate_filter+
         #   does not yield any cells when applied to +row_key+. Entries are applied in
         #   order, meaning that earlier mutations can be masked by later ones.
-        #   Must contain at least one entry if +true_mutations+ is empty, and at most
-        #   100000.
+        #   Must contain at least one entry if +true_mutations+ is empty and at most
+        #   100,000 entries.
         # @return [Boolean]
         #   Predicate match or not status
         # @example
@@ -252,9 +254,9 @@ module Google
         # Read sample row keys.
         #
         # Returns a sample of row keys in the table. The returned row keys will
-        # delimit contiguous sections of the table of approximately equal size,
-        # which can be used to break up the data for distributed tasks like
-        # mapreduces.
+        # delimit contiguous sections of the table of approximately equal size. The
+        # sections can be used to break up the data for distributed tasks like
+        # MapReduces.
         #
         # @yieldreturn [Google::Cloud::Bigtable::SampleRowKey]
         # @return [:yields: sample_row_key]
@@ -283,10 +285,10 @@ module Google
           end
         end
 
-        # Create instance of mutation_entry
+        # Create an instance of mutation_entry
         #
         # @param row_key [String] Row key. Optional
-        #   The key of the row to which the mutation should be applied.
+        #   The row key of the row to which the mutation should be applied.
         # @return [Google::Cloud::Bigtable::MutationEntry]
         #
         # @example
@@ -304,13 +306,13 @@ module Google
           Google::Cloud::Bigtable::MutationEntry.new(row_key)
         end
 
-        # Create instance of ReadModifyWriteRule to append or increment value
+        # Create an instance of ReadModifyWriteRule to append or increment the value
         # of the cell qualifier.
         #
         # @param family [String]
-        #   The name of the family to which the read/modify/write should be applied.
+        #   The name of the column family to which the read/modify/write should be applied.
         # @param qualifier [String]
-        #   The qualifier of the column to which the read/modify/write should be
+        #   The qualifier of the column to which the read/modify/write should be applied.
         # @return [Google::Cloud::Bigtable::ReadModifyWriteRule]
         #
         # @example Create rule to append to qualifier value.

data/lib/google/cloud/bigtable/policy.rb

@@ -18,22 +18,22 @@ module Google
     module Bigtable
       # # Policy
       #
-      # Represents a Cloud IAM Policy for the Bigtable instance resources.
+      # Represents a Cloud IAM Policy for Bigtable instance resources.
       #
-      # A common pattern for updating a resource's metadata, such as its Policy,
+      # A common pattern for updating a resource's metadata, such as its policy,
       # is to read the current data from the service, update the data locally,
-      # and then send the modified data for writing. This pattern may result in
-      # a conflict if two or more processes attempt the sequence simultaneously.
+      # and then write the modified data back to the resource. This pattern may
+      # result in a conflict if two or more processes attempt the sequence simultaneously.
       # IAM solves this problem with the {Google::Cloud::Bigtable::Policy#etag}
       # property, which is used to verify whether the policy has changed since
-      # the last request. When you make a request to with an `etag` value, Cloud
+      # the last request. When you make a request with an `etag` value, Cloud
       # IAM compares the `etag` value in the request with the existing `etag`
       # value associated with the policy. It writes the policy only if the
       # `etag` values match.
       #
       # @see https://cloud.google.com/bigtable/docs/access-control Permissions and roles
       #
-      # @attr [String] etag Used to verify whether the policy has changed since
+      # @attr [String] etag Used to check if the policy has changed since
       #   the last request. The policy will be written only if the `etag` values
       #   match.
       # @attr [Hash{String => Array<String>}] roles The bindings that associate
@@ -66,9 +66,9 @@ module Google
         # Convenience method for adding a member to a binding on this policy.
         # See [Understanding
         # Roles](https://cloud.google.com/iam/docs/understanding-roles) for a
-        # listing of primitive and curated roles. See
+        # list of primitive and curated roles. See
         # [Binding](https://cloud.google.com/bigtable/docs/access-control)
-        # for a listing of values and patterns for members.
+        # for a list of values and patterns for members.
         #
         # @param [String] role_name A Cloud IAM role, such as
         #   `"roles/bigtable.admin"`.
@@ -91,9 +91,9 @@ module Google
         # Convenience method for removing a member from a binding on this
         # policy. See [Understanding
         # Roles](https://cloud.google.com/iam/docs/understanding-roles) for a
-        # listing of primitive and curated roles.See
+        # list of primitive and curated roles.See
         # [Binding](https://cloud.google.com/bigtable/docs/access-control)
-        # for a listing of values and patterns for members.
+        # for a list of values and patterns for members.
         #
         # @param [String] role_name A Cloud IAM role, such as
         #   `"roles/Bigtable.admin"`.
@@ -114,12 +114,12 @@ module Google
         end
 
         # Convenience method returning the array of members bound to a role in
-        # this policy, or an empty array if no value is present for the role in
+        # this policy. Returns an empty array if no value is present for the role in
         # {#roles}. See [Understanding
         # Roles](https://cloud.google.com/iam/docs/understanding-roles) for a
-        # listing of primitive and curated roles. See
+        # list of primitive and curated roles. See
         # [Binding](https://cloud.google.com/bigtable/docs/access-control)
-        # for a listing of values and patterns for members.
+        # for a list of values and patterns for members.
         #
         # @return [Array<String>] The members strings, or an empty array.
         #

data/lib/google/cloud/bigtable/project.rb

@@ -64,7 +64,7 @@ module Google
 
         # The identifier for the Cloud Bigtable project.
         #
-        # @return [String] Project id.
+        # @return [String] Project ID.
         #
         # @example
         #   require "google/cloud"
@@ -84,7 +84,7 @@ module Google
         # Retrieves the list of Bigtable instances for the project.
         #
         # @param token [String] The `token` value returned by the last call to
-        #   `instances`; indicates that this is a continuation of a call,
+        #   `instances`; indicates that this is a continuation of a call
         #   and that the system should return the next page of data.
         # @return [Array<Google::Cloud::Bigtable::Instance>] The list of instances.
         #   (See {Google::Cloud::Bigtable::Instance::List})
@@ -105,7 +105,7 @@ module Google
           Instance::List.from_grpc(grpc, service)
         end
 
-        # Get existing Bigtable instance.
+        # Get an existing Bigtable instance.
         #
         # @param instance_id [String] Existing instance id.
         # @return [Google::Cloud::Bigtable::Instance, nil]
@@ -136,10 +136,10 @@ module Google
         # @param instance_id [String] The unique identifier for the instance,
         #   which cannot be changed after the instance is created. Values are of
         #   the form `[a-z][-a-z0-9]*[a-z0-9]` and must be between 6 and 30
-        #   characters in length. Required.
+        #   characters. Required.
         # @param display_name [String] The descriptive name for this instance as it
         #   appears in UIs. Must be unique per project and between 4 and 30
-        #   characters in length.
+        #   characters.
         # @param type [Symbol] The type of the instance.
         #   Valid values are `:DEVELOPMENT` or `:PRODUCTION`.
         #   Default `:PRODUCTION` instance will created if left blank.
@@ -147,20 +147,20 @@ module Google
         #   mechanism for organizing cloud resources into groups that reflect a
         #   customer's organizational needs and deployment strategies. Cloud
         #   Labels can be used to filter collections of resources. They can be
-        #   used to control how resource metrics are aggregated. And they can be
-        #   used as arguments to policy management rules (e.g. route, firewall,
-        #   load balancing, etc.).
+        #   used to control how resource metrics are aggregated. Cloud Labels can be
+        #   used as arguments to policy management rules (e.g., route, firewall, or
+        #   load balancing).
         #
-        #   * Label keys must be between 1 and 63 characters long and must
+        #   * Label keys must be between 1 and 63 characters and must
         #     conform to the following regular expression:
         #     `[a-z]([-a-z0-9]*[a-z0-9])?`.
-        #   * Label values must be between 0 and 63 characters long and must
+        #   * Label values must be between 0 and 63 characters and must
         #     conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.
         #   * No more than 64 labels can be associated with a given resource.
         # @param clusters [Hash{String => Google::Cloud::Bigtable::Cluster}]
         #   (See {Google::Cloud::Bigtable::Instance::ClusterMap})
         #   If unspecified, you may use a code block to add clusters.
-        #   Minimum one cluster must be specified.
+        #   Minimum of one cluster must be specified.
         # @yield [clusters] A block for adding clusters.
         # @yieldparam [Hash{String => Google::Cloud::Bigtable::Cluster}]
         #   Cluster map of cluster name and cluster object.
@@ -254,8 +254,8 @@ module Google
         # List all clusters in project.
         #
         # @param token [String] The `token` value returned by the last call to
-        #   `clusters`; indicates that this is a continuation of a call,
-        #   and that the system should return the next page of data.
+        #   `clusters` indicates that this is a continuation of a call
+        #   and the system should return the next page of data.
         # @return [Array<Google::Cloud::Bigtable::Cluster>]
         #   (See {Google::Cloud::Bigtable::Cluster::List})
         # @example
@@ -302,7 +302,7 @@ module Google
         # @param instance_id [String] Existing instance Id.
         # @param table_id [String] Existing table Id.
         # @param view [Symbol] Optional. Table view type. Default `:SCHEMA_VIEW`
-        #   Valid view types are.
+        #   Valid view types are the following:
         #   * `:NAME_ONLY` - Only populates `name`
         #   * `:SCHEMA_VIEW` - Only populates `name` and fields related to the table's schema
         #   * `:REPLICATION_VIEW` - Only populates `name` and fields related to the table's replication state.
@@ -311,9 +311,9 @@ module Google
         #   Get table object without verifying that the table resource exists.
         #   Calls made on this object will raise errors if the table does not exist.
         #   Default value is `false`. Optional.
-        #   It helps to reduce admin apis calls.
+        #   Helps to reduce admin API calls.
         # @param app_profile_id [String] The unique identifier for the app profile. Optional.
-        #   It is used only in data operations.
+        #   Used only in data operations.
         #   This value specifies routing for replication. If not specified, the
         #   "default" application profile will be used.
         # @return [Google::Cloud::Bigtable::Table, nil]
@@ -336,7 +336,7 @@ module Google
         #
         #   table = bigtable.table("my-instance", "my-table")
         #
-        # @example Get table with all fields. Clusters states, column families
+        # @example Get table with all fields, cluster states, and column families.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -404,17 +404,17 @@ module Google
         # specified in the request.
         #
         # @param instance_id [String]
-        #   The unique Id of the instance in which to create the table.
+        #   The unique ID of the instance in which to create the table.
         # @param table_id [String]
-        #   The name by which the new table should be referred to within the parent
-        #   instance, e.g., `foobar`
+        #   The ID by which the new table should be referred to within the
+        #   instance, e.g., `foobar`.
         # @param column_families [Hash{String => Google::Cloud::Bigtable::ColumnFamily}]
         #   (See {Google::Cloud::Bigtable::Table::ColumnFamilyMap})
         #   If unspecified, you may use a code block to add column families.
         # @param granularity [Symbol]
         #   The granularity at which timestamps are stored in this table.
         #   Timestamps not matching the granularity will be rejected.
-        #   Valid values are `:MILLIS`.
+        #   Valid value is `:MILLIS`.
         #   If unspecified, the value will be set to `:MILLIS`.
         # @param initial_splits [Array<String>]
         #   The optional list of row keys that will be used to initially split the
@@ -432,17 +432,17 @@ module Google
         #     * Tablet 3 : `[customer_1, customer_2) => {"customer_1"}`
         #     * Tablet 4 : `[customer_2, other)      => {"customer_2"}`
         #     * Tablet 5 : `[other, )                => {"other", "zz"}`
-        #   A hash of the same form as `Google::Bigtable::Admin::V2::CreateTableRequest::Split`
+        #   A hash in the form of `Google::Bigtable::Admin::V2::CreateTableRequest::Split`
         #   can also be provided.
         # @yield [column_families] A block for adding column_families.
         # @yieldparam [Hash{String => Google::Cloud::Bigtable::ColumnFamily}]
         #    Map of family name and column family object.
         #   (See {Google::Cloud::Bigtable::Instance::ColumnFamilyMap})
-        #   GC Rules for column family see {Google::Cloud::Bigtable::GcRule})
+        #   (Read the GC Rules for column families at {Google::Cloud::Bigtable::GcRule})
         #
         # @return [Google::Cloud::Bigtable::Table]
         #
-        # @example Create table without column family
+        # @example Create a table without a column family
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -491,9 +491,9 @@ module Google
         # Permanently deletes a specified table and all of its data.
         #
         # @param instance_id [String]
-        #  The unique Id of the instance in which table is exists.
+        #  The unique ID of the instance the table is in.
         # @param table_id [String]
-        #   The unique name of the table to be deleted.
+        #   The unique ID of the table to be deleted,
         #   e.g., `foobar`
         #
         # @example Create table with column families and initial splits.
@@ -514,7 +514,7 @@ module Google
         # where only some modifications have taken effect.
         #
         # @param instance_id [String]
-        #   The unique Id of the instance in which table is exists.
+        #   The unique ID of the instance the table is in.
         # @param table_id [String]
         #   The unique Id of the table whose families should be modified.
         # @param modifications [Array<Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification> | Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification]