Fix documentation based on feedback

2 files changed, 7 insertions, 3 deletions

diff --git a/activerecord/lib/active_record/persistence.rb b/activerecord/lib/active_record/persistence.rb
index 72d92ef504..155d67fd8f 100644
--- a/activerecord/lib/active_record/persistence.rb
+++ b/activerecord/lib/active_record/persistence.rb
@@ -70,8 +70,12 @@ module ActiveRecord
         instantiate_instance_of(klass, attributes, column_types, &block)
       end
 
-      # Given a class, an attributes hash, +instantiate+ returns a new instance
-      # of the class. Accepts only keys as strings.
+      # Given a class, an attributes hash, +instantiate_instance_of+ returns a
+      # new instance of the class. Accepts only keys as strings.
+      #
+      # This is private, don't call it. :)
+      #
+      # :nodoc:
       def instantiate_instance_of(klass, attributes, column_types = {}, &block)
         attributes = klass.attributes_builder.build_from_database(attributes, column_types)
         klass.allocate.init_from_db(attributes, &block)
diff --git a/activerecord/lib/active_record/result.rb b/activerecord/lib/active_record/result.rb
index 3549e8a3fa..7f1c2fd7eb 100644
--- a/activerecord/lib/active_record/result.rb
+++ b/activerecord/lib/active_record/result.rb
@@ -43,7 +43,7 @@ module ActiveRecord
       @column_types = column_types
     end
 
-    # Does this result set include the column named +name+ ?
+    # Returns true if this result set includes the column named +name+
     def includes_column?(name)
       @columns.include? name
     end