google-cloud-bigtable 0.8.0 → 1.0.0

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

@@ -86,7 +86,7 @@ module Google
         #   The default (zero) is to return all results.
         # @return [Array<Google::Cloud::Bigtable::Row> | :yields: row]
         #   Array of row or yield block for each processed row.
-        # @example Read with limit
+        # @example Read with limit.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -96,7 +96,7 @@ module Google
         #     puts row
         #   end
         #
-        # @example Read using row keys
+        # @example Read using row keys.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -106,7 +106,7 @@ module Google
         #     puts row
         #   end
         #
-        # @example Read using row ranges
+        # @example Read using row ranges.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -118,8 +118,7 @@ module Google
         #     puts row
         #   end
         #
-        # @example Read using filter
-        #
+        # @example Read using filter.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -133,8 +132,7 @@ module Google
         #     puts row
         #   end
         #
-        # @example Read using filter with limit
-        #
+        # @example Read using filter with limit.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -169,13 +167,12 @@ module Google
         ##
         # Reads a single row by row key.
         #
-        # @param key [String] Row key. Required
+        # @param key [String] Row key. Required.
         # @param filter [Google::Cloud::Bigtable::RowFilter]
         #   The filter to apply to the contents of the specified row. Optional.
         # @return [Google::Cloud::Bigtable::Row]
         #
-        # @example Read row
-        #
+        # @example
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -183,8 +180,7 @@ module Google
         #
         #   row = table.read_row("user-1")
         #
-        # @example Read row
-        #
+        # @example Read row with filter.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -216,7 +212,7 @@ module Google
         #   # OR
         #   range = table.new_value_range.from("abc").to("xyz")
         #
-        # @example With exclusive from range
+        # @example With exclusive from range.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -229,9 +225,9 @@ module Google
         end
 
         ##
-        # Get a new instance of ColumnRange.
+        # Gets a new instance of ColumnRange.
         #
-        # @param family [String] Column family name
+        # @param family [String] Column family name.
         # @return [Google::Cloud::Bigtable::ColumnRange]
         #
         # @example
@@ -247,7 +243,7 @@ module Google
         #   # OR
         #   range = table.new_column_range("test-family").from("key-1").to("key-5")
         #
-        # @example With exclusive from range
+        # @example With exclusive from range.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -260,7 +256,7 @@ module Google
         end
 
         ##
-        # Get a new instance of RowRange.
+        # Gets a new instance of RowRange.
         #
         # @return [Google::Cloud::Bigtable::RowRange]
         #
@@ -277,7 +273,7 @@ module Google
         #   # OR
         #   range = table.new_row_range.from("key-1").to("key-5")
         #
-        # @example With exclusive from range
+        # @example With exclusive from range.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new

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

@@ -33,7 +33,7 @@ module Google
       #   availability. Value contains `cluster_id` and optional field
       #   `allow_transactional_writes`.
       #
-      # @example Create an app profile with a single cluster routing policy
+      # @example Create an app profile with a single cluster routing policy.
       #   require "google/cloud/bigtable"
       #
       #   bigtable = Google::Cloud::Bigtable.new
@@ -52,7 +52,7 @@ module Google
       #   )
       #   puts app_profile.routing_policy
       #
-      # @example Create an app profile with multi-cluster routing policy
+      # @example Create an app profile with multi-cluster routing policy.
       #   require "google/cloud/bigtable"
       #
       #   bigtable = Google::Cloud::Bigtable.new
@@ -139,6 +139,7 @@ module Google
       #     allowed by this app profile. It is unsafe to send these requests to
       #     the same table/row/column in multiple clusters.
       #     Default value is false.
+      #
       class SingleClusterRouting < RoutingPolicy
         attr_reader :cluster_id, :allow_transactional_writes
 

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

@@ -35,11 +35,11 @@ module Google
           ##
           # Creates a row cell instance.
           #
-          # @param family [String] Column family name
-          # @param qualifier [String] Column cell qualifier name
-          # @param timestamp [Integer] Timestamp in microseconds
-          # @param value [String] Cell value
-          # @param labels [Array<String>] List of label array
+          # @param family [String] Column family name.
+          # @param qualifier [String] Column cell qualifier name.
+          # @param timestamp [Integer] Timestamp in microseconds.
+          # @param value [String] Cell value.
+          # @param labels [Array<String>] List of label array.
           #
           def initialize family, qualifier, timestamp, value, labels = []
             @family = family
@@ -52,9 +52,9 @@ module Google
           ##
           # Converts timestamp to Time instance.
           #
-          # @param granularity [Symbol] Optional
-          #   Valid granularity types are `:micros`, `millis`
-          #   Default granularity is a millis.
+          # @param granularity [Symbol] Optional.
+          #   Valid granularity types are `:micros`, `:millis`.
+          #   Default is `:millis`.
           # @return [Time | nil]
           #
           def to_time granularity = nil
@@ -74,7 +74,7 @@ module Google
 
           # @private
           #
-          # Cell object comparator
+          # Cell object comparator.
           #
           # @return [Boolean]
           #
@@ -88,19 +88,19 @@ module Google
         end
 
         ##
-        # @return [String] Row key
+        # @return [String] Row key.
         #
         attr_accessor :key
 
         ##
-        # @return [Hash{String => Array<Google::Cloud::Bigtable::Row::Cell>}] Row cells
+        # @return [Hash{String => Array<Google::Cloud::Bigtable::Row::Cell>}] Row cells.
         #
         attr_accessor :cells
 
         ##
         # Creates a flat row object.
         #
-        # @param key [String] Row key name
+        # @param key [String] Row key name.
         #
         def initialize key = nil
           @key = key
@@ -108,7 +108,7 @@ module Google
         end
 
         ##
-        # List of column families names
+        # List of column families names.
         #
         # @return [Array<String>]
         #
@@ -118,7 +118,7 @@ module Google
 
         # @private
         #
-        # FlatRow object comparator
+        # FlatRow object comparator.
         #
         # @return [Boolean]
         #

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

@@ -121,6 +121,7 @@ module Google
       # while the other does not.
       #
       # @example
+      #   require "google/cloud/bigtable"
       #
       #   # Pass filter
       #   Google::Cloud::Bigtable::RowFilter.pass
@@ -151,7 +152,7 @@ module Google
         #
         # A chain RowFilter that sends rows through several RowFilters in sequence.
         #
-        # See {Google::Cloud::Bigtable::RowFilter::ChainFilter}
+        # See {Google::Cloud::Bigtable::RowFilter::ChainFilter}.
         #
         # The elements of "filters" are chained together to process the input row:
         # in row -> f(0) -> intermediate row -> f(1) -> ... -> f(N) -> out row
@@ -160,6 +161,7 @@ module Google
         # @return [Google::Cloud::Bigtable::RowFilter::ChainFilter]
         #
         # @example Create chain filter with simple filter.
+        #   require "google/cloud/bigtable"
         #
         #   chain = Google::Cloud::Bigtable::RowFilter.chain
         #
@@ -171,6 +173,7 @@ module Google
         #   chain.key("user-*").strip_value
         #
         # @example Create complex chain filter.
+        #   require "google/cloud/bigtable"
         #
         #   chain = Google::Cloud::Bigtable::RowFilter.chain
         #
@@ -219,6 +222,7 @@ module Google
         # @return [Google::Cloud::Bigtable::RowFilter::InterleaveFilter]
         #
         # @example Create an interleave filter with simple filter.
+        #   require "google/cloud/bigtable"
         #
         #   interleave = Google::Cloud::Bigtable::RowFilter.interleave
         #
@@ -230,6 +234,7 @@ module Google
         #   interleave.key("user-*").sink
         #
         # @example Create complex interleave filter.
+        #   require "google/cloud/bigtable"
         #
         #   interleave = Google::Cloud::Bigtable::RowFilter.interleave
         #
@@ -254,12 +259,13 @@ module Google
         # results. Additionally, condition filters have poor performance, especially
         # when filters are set for the false condition.
         #
-        # Cannot be used within the `predicate_filter`, `true_filter`, or `false_filter`
+        # Cannot be used within the `predicate_filter`, `true_filter`, or `false_filter`.
         #
         # @param predicate [SimpleFilter, ChainFilter, InterleaveFilter, ConditionFilter]
         # @return [Google::Cloud::Bigtable::RowFilter::ConditionFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   predicate = Google::Cloud::Bigtable::RowFilter.key("user-*")
         #   condition = Google::Cloud::Bigtable::RowFilter.condition(predicate)
@@ -283,6 +289,7 @@ module Google
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.pass
         #
@@ -299,6 +306,7 @@ module Google
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.block
         #
@@ -310,11 +318,12 @@ module Google
         # Creates a sink filter instance.
         #
         # Outputs all cells directly to the output of the read rather than to any
-        # parent filter
+        # parent filter.
         #
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.sink
         #
@@ -330,6 +339,7 @@ module Google
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.strip_value
         #
@@ -348,13 +358,13 @@ module Google
         # will not match the new line character `\n`, which may be present in a
         # binary key.
         #
-        # For Regex syntax:
-        # @see https://github.com/google/re2/wiki/Syntax
+        # @see https://github.com/google/re2/wiki/Syntax Regex syntax
         #
         # @param regex [String] Regex to match row keys.
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.key("user-.*")
         #
@@ -368,11 +378,12 @@ module Google
         # Matches all cells from a row with probability p, and matches no cells
         # from the row with probability 1-p.
         #
-        # @param probability [Float] Probability value
-        #   Probability must be greather then 0 and less then 1.0
+        # @param probability [Float] Probability value.
+        #   Probability must be greater than 0 and less than 1.0.
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.sample(0.5)
         #
@@ -390,13 +401,13 @@ module Google
         # `\n`, it is sufficient to use `.` as a full wildcard when matching
         # column family names.
         #
-        # For Regex syntax:
-        # @see https://github.com/google/re2/wiki/Syntax
+        # @see https://github.com/google/re2/wiki/Syntax Regex syntax
         #
         # @param regex [String] Regex to match family name.
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.family("cf-.*")
         #
@@ -414,13 +425,13 @@ module Google
         # character will not match the new line character `\n`, which may be
         # present in a binary qualifier.
         #
-        # For Regex syntax:
-        # @see https://github.com/google/re2/wiki/Syntax
+        # @see https://github.com/google/re2/wiki/Syntax Regex syntax
         #
         # @param regex [String] Regex to match column qualifier name.
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.qualifier("user-name.*")
         #
@@ -437,13 +448,13 @@ module Google
         # will not match the new line character `\n`, which may be present in a
         # binary value.
         #
-        # For Regex syntax:
-        # @see https://github.com/google/re2/wiki/Syntax
+        # @see https://github.com/google/re2/wiki/Syntax Regex syntax
         #
         # @param regex [String] Regex to match cell value.
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.value("abc.*")
         #
@@ -472,6 +483,7 @@ module Google
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.label("user-detail")
         #
@@ -490,6 +502,7 @@ module Google
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.cells_per_row_offset(3)
         #
@@ -508,6 +521,7 @@ module Google
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.cells_per_row(5)
         #
@@ -526,6 +540,7 @@ module Google
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   filter = Google::Cloud::Bigtable::RowFilter.cells_per_column(5)
         #
@@ -544,6 +559,7 @@ module Google
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   timestamp_micros = (Time.now.to_f * 1000000).round(-3)
         #   from = timestamp_micros - 300000000
@@ -577,7 +593,7 @@ module Google
         # @param range [Google::Cloud::Bigtable::ValueRange]
         # @return [Google::Cloud::Bigtable::RowFilter::SimpleFilter]
         #
-        # @example Start to end range
+        # @example Start to end range.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new
@@ -586,7 +602,7 @@ module Google
         #   range = table.new_value_range.from("value-001", inclusive: false)
         #   filter = Google::Cloud::Bigtable::RowFilter.value_range(range)
         #
-        # @example Start exlusive to infinite end range
+        # @example Start exclusive to infinite end range.
         #   require "google/cloud/bigtable"
         #
         #   bigtable = Google::Cloud::Bigtable.new

data/lib/google/cloud/bigtable/row_filter/chain_filter.rb

@@ -25,10 +25,13 @@ module Google
         # A RowFilter that sends rows through several RowFilters in sequence.
         #
         # The elements of "filters" are chained together to process the input row:
-        # in row -> f(0) -> intermediate row -> f(1) -> ... -> f(N) -> out row
+        #
+        #     in row -> f(0) -> intermediate row -> f(1) -> ... -> f(N) -> out row
+        #
         # The full chain is executed atomically.
         #
         # @example
+        #   require "google/cloud/bigtable"
         #
         #   chain = Google::Cloud::Bigtable::RowFilter.chain
         #   # Add filters to chain filter
@@ -42,12 +45,14 @@ module Google
           end
 
           ##
-          # Adds a chain filter instance.
+          # Adds a chain filter.
           #
           # A Chain RowFilter that sends rows through several RowFilters in sequence.
           #
           # The elements of "filters" are chained together to process the input row:
-          # in row -> f(0) -> intermediate row -> f(1) -> ... -> f(N) -> out row
+          #
+          #     in row -> f(0) -> intermediate row -> f(1) -> ... -> f(N) -> out row
+          #
           # The full chain is executed atomically.
           #
           # @param filter [SimpleFilter, ChainFilter, InterleaveFilter, ConditionFilter]
@@ -55,6 +60,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example Create a chain filter and add a chain filter.
+          #   require "google/cloud/bigtable"
           #
           #   chain_1 = Google::Cloud::Bigtable::RowFilter.chain
           #
@@ -73,7 +79,7 @@ module Google
           end
 
           ##
-          # Add interleave filter.
+          # Adds an interleave filter.
           #
           # A RowFilter that sends each row to each of several component
           # RowFilters and interleaves the results.
@@ -110,7 +116,8 @@ module Google
           # @return [Google::Cloud::Bigtable::RowFilter::ChainFilter]
           #   `self` instance of chain filter.
           #
-          # @example Add interleave filter to chain filter
+          # @example Add an interleave filter to the chain filter.
+          #   require "google/cloud/bigtable"
           #
           #   interleave = Google::Cloud::Bigtable::RowFilter.interleave
           #
@@ -125,7 +132,7 @@ module Google
           end
 
           ##
-          # Adds a condition filter instance.
+          # Adds a condition filter.
           #
           # A RowFilter that evaluates one of two possible RowFilters, depending on
           # whether or not a predicate RowFilter outputs any cells from the input row.
@@ -142,6 +149,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   predicate = Google::Cloud::Bigtable::RowFilter.key("user-*")
           #
@@ -159,7 +167,7 @@ module Google
           end
 
           ##
-          # Adds a pass filter instance.
+          # Adds a pass filter.
           #
           # Matches all cells, regardless of input. Functionally equivalent to
           # leaving `filter` unset, but included for completeness.
@@ -168,6 +176,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.pass
           #
@@ -176,7 +185,7 @@ module Google
           end
 
           ##
-          # Adds a block-all filter instance.
+          # Adds a block-all filter.
           #
           # Does not match any cells, regardless of input. Useful for temporarily
           # disabling just part of a filter.
@@ -185,6 +194,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.block
           #
@@ -193,7 +203,7 @@ module Google
           end
 
           ##
-          # Adds a sink filter instance.
+          # Adds a sink filter.
           #
           # Outputs all cells directly to the output of the read rather than to any parent filter.
           #
@@ -201,6 +211,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.sink
           #
@@ -209,7 +220,7 @@ module Google
           end
 
           ##
-          # Adds a strip-value filter instance.
+          # Adds a strip-value filter.
           #
           # Replaces each cell's value with an empty string.
           #
@@ -217,6 +228,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.strip_value
           #
@@ -243,6 +255,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.key("user-*")
           #
@@ -251,17 +264,18 @@ module Google
           end
 
           ##
-          # Adds a sample-probability filter instance.
+          # Adds a sample-probability filter.
           #
           # Matches all cells from a row with probability p, and matches no cells
           # from the row with probability 1-p.
           #
-          # @param probability [Float] Probability value
-          #   Probability must be greather then 0 and less then 1.0.
+          # @param probability [Float] Probability value.
+          #   Probability must be greater than 0 and less than 1.0.
           # @return [Google::Cloud::Bigtable::RowFilter::ChainFilter]
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.sample(0.5)
           #
@@ -287,6 +301,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.family("cf-*")
           #
@@ -295,7 +310,7 @@ module Google
           end
 
           ##
-          # Add a column-qualifier-match filter using a regular expression.
+          # Adds a column-qualifier-match filter using a regular expression.
           #
           # Matches only cells from columns whose qualifiers satisfy the given RE2
           # regex.
@@ -312,6 +327,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.qualifier("user-name*")
           #
@@ -336,6 +352,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.value("abc*")
           #
@@ -364,6 +381,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.label("user-detail")
           #
@@ -383,6 +401,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.cells_per_row_offset(3)
           #
@@ -391,17 +410,18 @@ module Google
           end
 
           ##
-          # Adds a cells-per-row-limit filter instance.
+          # Adds a cells-per-row-limit filter.
           #
           # Matches only the first N cells of each row.
           # If duplicate cells are present, as is possible when using an Interleave,
           # each copy of the cell is counted separately.
           #
-          # @param limit [String] Max cell match per row limit
+          # @param limit [String] Max cell match per row limit.
           # @return [Google::Cloud::Bigtable::RowFilter::ChainFilter]
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.cells_per_row(5)
           #
@@ -410,7 +430,7 @@ module Google
           end
 
           ##
-          # Adds a cells-per-column filter instance.
+          # Adds a cells-per-column filter.
           #
           # Matches only the most recent N cells within each column. For example,
           # if N=2, this filter would match column `foo:bar` at timestamps 10 and 9,
@@ -419,11 +439,12 @@ module Google
           # If duplicate cells are present, as is possible when using an Interleave,
           # each copy of the cell is counted separately.
           #
-          # @param limit [String] Max cell match per column limit
+          # @param limit [String] Max cell match per column limit.
           # @return [Google::Cloud::Bigtable::RowFilter::ChainFilter]
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.cells_per_column(5)
           #
@@ -432,7 +453,7 @@ module Google
           end
 
           ##
-          # Adds a timestamp-range filter instance.
+          # Adds a timestamp-range filter.
           #
           # Matches only cells with timestamps within the given range.
           # Specifies a contiguous range of timestamps.
@@ -445,6 +466,7 @@ module Google
           #   `self` instance of chain filter.
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
           #   timestamp_micros = (Time.now.to_f * 1000000).round(-3)
           #   from = timestamp_micros - 300000000
@@ -457,12 +479,12 @@ module Google
           end
 
           ##
-          # Adds a value-range filter instance.
+          # Adds a value-range filter.
           #
           # Matches only cells with values that fall within the given range.
           #
           # See {Google::Cloud::Bigtable::ValueRange#from} and { Google::Cloud::Bigtable::ValueRange#to} for range
-          # option inclusive/exclusive options
+          # option inclusive/exclusive options.
           #
           # * The value at which to start the range. If neither field is set, interpreted as an empty string, inclusive.
           # * The value at which to end the range. If neither field is set, interpreted as the infinite string,
@@ -472,7 +494,7 @@ module Google
           # @return [Google::Cloud::Bigtable::RowFilter::ChainFilter]
           #   `self` instance of chain filter.
           #
-          # @example Start to end range
+          # @example Start to end range.
           #   require "google/cloud/bigtable"
           #
           #   bigtable = Google::Cloud::Bigtable.new
@@ -481,7 +503,7 @@ module Google
           #   range = table.new_value_range.from("value-001").to("value-005")
           #   filter = Google::Cloud::Bigtable::RowFilter.chain.value_range(range)
           #
-          # @example Start exclusive to infinite end range
+          # @example Start exclusive to infinite end range.
           #   require "google/cloud/bigtable"
           #
           #   bigtable = Google::Cloud::Bigtable.new
@@ -495,7 +517,7 @@ module Google
           end
 
           ##
-          # Adds a column-range filter instance.
+          # Adds a column-range filter.
           #
           # Matches only cells from columns within the given range.
           #
@@ -520,9 +542,10 @@ module Google
           # @return [Integer]
           #
           # @example
+          #   require "google/cloud/bigtable"
           #
-          #  filter = Google::Cloud::Bigtable::RowFilter.chain.key("user-1*").label("user")
-          #  filter.length # 2
+          #   filter = Google::Cloud::Bigtable::RowFilter.chain.key("user-1*").label("user")
+          #   filter.length # 2
           #
           def length
             @filters.length