[DSL] Add documentation to methods in bucket_sort

Author: estolfo

lib/elasticsearch/dsl/search/aggregations/pipeline/bucket_sort.rb

@@ -44,6 +44,19 @@ module Aggregations
         class BucketSort
           include BaseAggregationComponent
 
+          # Add a sort clause to the search definition.
+          #
+          # @example
+          #
+          #   bucket_sort do
+          #     sort do
+          #       by :total_sales, order: 'desc'
+          #     end
+          #   end
+          #
+          # @return [ Sort, Hash ] The sort definition.
+          #
+          # @since 0.1.9
           def sort(*args, &block)
             if !args.empty? || block
               @sort = Sort.new(*args, &block)
@@ -53,6 +66,25 @@ def sort(*args, &block)
             end
           end
 
+          # Get a hash representation of the aggregation.
+          #
+          # @example
+          #
+          #   s = search do
+          #     aggregation do
+          #       bucket_sort do
+          #         sort do
+          #           by :total_sales, order: 'desc'
+          #         end
+          #       end
+          #     end
+          #   end
+          #
+          # client.search(body: s.to_hash)
+          #
+          # @return [ Hash ] The hash representation of the aggregation.
+          #
+          # @since 0.1.9
           def to_hash
             call