2 files changed, 7 insertions, 5 deletions
diff --git a/activesupport/lib/active_support/core_ext/array/conversions.rb b/activesupport/lib/active_support/core_ext/array/conversions.rb
index 430a35fbaf..3807ee63b1 100644
--- a/activesupport/lib/active_support/core_ext/array/conversions.rb
+++ b/activesupport/lib/active_support/core_ext/array/conversions.rb
@@ -12,7 +12,7 @@ class Array
   # pass an option key that doesn't exist in the list below, it will raise an
   # <tt>ArgumentError</tt>.
   #
-  # Options:
+  # ==== Options
   #
   # * <tt>:words_connector</tt> - The sign or word used to join the elements
   #   in arrays with two or more elements (default: ", ").
@@ -24,6 +24,8 @@ class Array
   #   the connector options defined on the 'support.array' namespace in the
   #   corresponding dictionary file.
   #
+  # ==== Examples
+  #
   #   [].to_sentence                      # => ""
   #   ['one'].to_sentence                 # => "one"
   #   ['one', 'two'].to_sentence          # => "one and two"
@@ -38,10 +40,10 @@ class Array
   #   ['one', 'two', 'three'].to_sentence(words_connector: ' or ', last_word_connector: ' or at least ')
   #   # => "one or two or at least three"
   #
-  # Examples using <tt>:locale</tt> option:
+  # Using <tt>:locale</tt> option:
   #
   #   # Given this locale dictionary:
-  #   # 
+  #   #
   #   #   es:
   #   #     support:
   #   #       array:
diff --git a/activesupport/lib/active_support/core_ext/array/uniq_by.rb b/activesupport/lib/active_support/core_ext/array/uniq_by.rb
index ca3b7748cd..23573c97de 100644
--- a/activesupport/lib/active_support/core_ext/array/uniq_by.rb
+++ b/activesupport/lib/active_support/core_ext/array/uniq_by.rb
@@ -1,5 +1,5 @@
 class Array
-  # *DEPRECATED*: Use +Array#uniq+ instead.
+  # *DEPRECATED*: Use <tt>Array#uniq</tt> instead.
   #
   # Returns a unique array based on the criteria in the block.
   #
@@ -9,7 +9,7 @@ class Array
     uniq(&block)
   end
 
-  # *DEPRECATED*: Use +Array#uniq!+ instead.
+  # *DEPRECATED*: Use <tt>Array#uniq!</tt> instead.
   #
   # Same as +uniq_by+, but modifies +self+.
   def uniq_by!(&block)