1 files changed, 13 insertions, 1 deletions
diff --git a/actionpack/lib/action_controller/assertions/dom_assertions.rb b/actionpack/lib/action_controller/assertions/dom_assertions.rb
index 0b8c78d9b3..5ffe5f1883 100644
--- a/actionpack/lib/action_controller/assertions/dom_assertions.rb
+++ b/actionpack/lib/action_controller/assertions/dom_assertions.rb
@@ -2,6 +2,12 @@ module ActionController
   module Assertions
     module DomAssertions
       # Test two HTML strings for equivalency (e.g., identical up to reordering of attributes)
+      #
+      # ==== Examples
+      #
+      #   # assert that the referenced method generates the appropriate HTML string
+      #   assert_dom_equal '<a href="http://www.example.com">Apples</a>', link_to("Apples", "http://www.example.com")
+      #
       def assert_dom_equal(expected, actual, message = "")
         clean_backtrace do
           expected_dom = HTML::Document.new(expected).root
@@ -13,6 +19,12 @@ module ActionController
       end
       
       # The negated form of +assert_dom_equivalent+.
+      #
+      # ==== Examples
+      #
+      #   # assert that the referenced method does not generate the specified HTML string
+      #   assert_dom_not_equal '<a href="http://www.example.com">Apples</a>', link_to("Oranges", "http://www.example.com")
+      #
       def assert_dom_not_equal(expected, actual, message = "")
         clean_backtrace do
           expected_dom = HTML::Document.new(expected).root
@@ -24,4 +36,4 @@ module ActionController
       end
     end
   end
-end
-\ No newline at end of file
+end