Add yard doc and description in have_rendered.rb, add more

descriptive param name in spec

Author: Alex Egan

lib/rspec/rails/matchers/have_rendered.rb

@@ -21,6 +21,11 @@ def matches?(*)
             match_check
           end
 
+          # Uses normalize_argument_to_redirection to find and format
+          # the redirect location. normalize_argument_to_redirection is private
+          # in ActionDispatch::Assertions::ResponseAssertions so we call it
+          # here using #send. This will keep the error message format consistent
+          # @api private
           def check_redirect
             response = @scope.response
             return unless response.respond_to?(:redirect?) && response.redirect?

spec/rspec/rails/matchers/have_rendered_spec.rb

@@ -95,7 +95,7 @@ def assert_template(*)
           message = "expecting <'template_name'> but rendering with <[]>"
           raise ActiveSupport::TestCase::Assertion.new(message)
         end
-        def normalize_argument_to_redirection(*)
+        def normalize_argument_to_redirection(response_redirect_location)
           "http://test.host/widgets/1"
         end
         it "gives informative error message" do