lib/datarank/comments.rb in datarank-0.2 vs lib/datarank/comments.rb in datarank-1.0.0

@@ -1,9 +1,19 @@
 module Datarank
   class Client
+
+    # Module containing methods for interacting with comments
     module Comments
+
+      # Query interface for comments correlated to a topic
+      #
+      # @param slug [String] A topic's unique identifier slug
+      # @option options [1..1000] :limit The number of items to return.
+      # @option options - all query options available in API docs
       def comments_search(slug, options={})
         get "/topics/#{slug}/comments", options
       end
+
     end
+
   end
 end
\ No newline at end of file