added a few more docs

lib/disqus/author.rb

@@ -9,6 +9,7 @@ def initialize(id, username, display_name, url, email_hash, has_avatar)
       @id, @username, @display_name, @url, @email_hash, @has_avatar = id, username, display_name, url, email_hash, has_avatar
     end
 
+    # returns the user's <tt>display_name</tt> or <tt>username</tt> if <tt>display_name</tt> is blank.
     def name
       @display_name.blank? ? @username : @display_name
     end

lib/disqus/post.rb

@@ -7,6 +7,7 @@ def initialize(id, forum, thread, created_at, message, parent_post, shown, is_an
          @id, @forum, @thread, @created_at, @message, @parent_post, @shown, @is_anonymous, @author = id.to_i, forum, thread, Time.parse(created_at.to_s), message, parent_post, shown, is_anonymous, author
     end
 
+    # Returns an array of Post objects representing all posts belonging to the given thread. The arrays is sorted in order of created_at date.
     def self.list(thread)
       response = Disqus::Api::get_thread_posts(:thread_id =>thread.id, :forum_api_key => thread.forum.key)
       if response["succeeded"]
@@ -38,4 +39,6 @@ def self.list(thread)
       end
     end
   end
-end
+end
+
+

lib/disqus/thread.rb

@@ -8,6 +8,7 @@ def initialize(id, forum, slug, title, created_at, allow_comments, url, identifi
       @posts = []
     end
 
+    # Threads are equal if all their attributes are equal.
     def ==(other_thread)
       id             == other_thread.id             &&
       forum          == other_thread.forum          &&
@@ -19,6 +20,7 @@ def ==(other_thread)
       identifier     == other_thread.identifier
     end
 
+    # returns an array of Thread objects representing the threads belonging to the given Forum.
     def self.list(forum, opts = {})
       response = Disqus::Api::get_thread_list(opts.merge(:forum_id =>forum.id, :forum_api_key => forum.key))
       if response["succeeded"]
@@ -43,6 +45,14 @@ def posts(force_update = false)
       @posts
     end
 
+    # Sets the provided values on the thread object.
+    #
+    # options:
+    # *  :thread_id     
+    # *  :title         
+    # *  :slug          
+    # *  :url           
+    # *  :allow_comments
     def update(opts = {})
       result = Disqus::Api::update_thread(opts.merge( :forum_api_key  => forum.key,
                                                       :thread_id      => id,