copy edits [ci skip]

actionpack/lib/action_dispatch/http/headers.rb

@@ -28,7 +28,7 @@ def [](key)
         @env[env_name(key)]
       end
 
-      # Set the given value for the key mapped to @env.
+      # Sets the given value for the key mapped to @env.
       def []=(key, value)
         @env[env_name(key)] = value
       end
@@ -36,12 +36,13 @@ def []=(key, value)
       def key?(key); @env.key? key; end
       alias :include? :key?
 
-
       # Returns the value for the given key mapped to @env.
-      # If the key can’t be found, there are several options:
-      # with no other arguments, it will raise an KeyError exception;
-      # If the optional code block is specified, then that will be run and its
-      # result returned.
+      #
+      # If the key is not found and an optional code block is not provided,
+      # raises a <tt>KeyError</tt> exception.
+      #
+      # If the code block is provided, then it will be run and
+      # its result returned.
       def fetch(key, *args, &block)
         @env.fetch env_name(key), *args, &block
       end
@@ -50,7 +51,6 @@ def each(&block)
         @env.each(&block)
       end
 
-
       # Returns a new Http::Headers instance containing the contents of
       # <tt>headers_or_env</tt> and the original instance.
       def merge(headers_or_env)
@@ -60,7 +60,7 @@ def merge(headers_or_env)
       end
 
       # Adds the contents of <tt>headers_or_env</tt> to original instance
-      # entries with duplicate keys are overwritten with the values from
+      # entries; duplicate keys are overwritten with the values from
       # <tt>headers_or_env</tt>.
       def merge!(headers_or_env)
         headers_or_env.each do |key, value|

activerecord/lib/active_record/attribute_assignment.rb

@@ -12,15 +12,14 @@ module AttributeAssignment
     # of this method is +false+ an <tt>ActiveModel::ForbiddenAttributesError</tt>
     # exception is raised.
     #
-    # Example:
-    #
     #   cat = Cat.new(name: "Gorby", status: "yawning")
-    #   cat.attributes # =>  {"name" => "Gorby", "status" => "yawning"}
+    #   cat.attributes # =>  { "name" => "Gorby", "status" => "yawning" }
     #   cat.assign_attributes(status: "sleeping")
-    #   cat.attributes # =>  {"name" => "Gorby", "status" => "sleeping"}
+    #   cat.attributes # =>  { "name" => "Gorby", "status" => "sleeping" }
+    #
+    # New attributes will be persisted in the database when the object is saved.
     #
-    # New attributes will be persisted to database when object is saved.
-    # <tt>attributes =</tt> is an alias.
+    # Aliased to <tt>attributes=</tt>.
     def assign_attributes(new_attributes)
       if !new_attributes.respond_to?(:stringify_keys)
         raise ArgumentError, "When assigning attributes, you must pass a hash as an argument."