Merge pull request rails#48029 from p8/docs/actionpack-headers

Cleanup Action Pack documentation headers [ci-skip]

Author: p8

actionpack/lib/abstract_controller/url_for.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 module AbstractController
+  # = URL For
+  #
   # Includes +url_for+ into the host class (e.g. an abstract controller or mailer). The class
   # has to provide a +RouteSet+ by implementing the <tt>_routes</tt> methods. Otherwise, an
   # exception will be raised.

actionpack/lib/action_controller/api.rb

@@ -5,7 +5,7 @@
 require "action_controller/log_subscriber"
 
 module ActionController
-  # = Action \Controller \Base
+  # = Action Controller \API
   #
   # API Controller is a lightweight version of ActionController::Base,
   # created for applications that don't require all functionalities that a complete

actionpack/lib/action_controller/metal/data_streaming.rb

@@ -4,7 +4,7 @@
 require "action_dispatch/http/content_disposition"
 
 module ActionController # :nodoc:
-  # = Action Controller Data Streaming
+  # = Action Controller Data \Streaming
   #
   # Methods for sending arbitrary data and for streaming files to the browser,
   # instead of rendering.

actionpack/lib/action_controller/metal/etag_with_flash.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module ActionController
-  # = Action Controller Etag With Flash
+  # = Action Controller Etag With \Flash
   #
   # When you're using the flash, it's generally used as a conditional on the view.
   # This means the content of the view depends on the flash. Which in turn means

actionpack/lib/action_controller/metal/etag_with_template_digest.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module ActionController
-  # = Action Controller Etag With Template Digest
+  # = Action Controller Etag With Template \Digest
   #
   # When our views change, they should bubble up into HTTP cache freshness
   # and bust browser caches. So the template digest for the current action

actionpack/lib/action_controller/metal/helpers.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 module ActionController
+  # = Action Controller \Helpers
+  #
   # The \Rails framework provides a large number of helpers for working with assets, dates, forms,
   # numbers and model objects, to name a few. These helpers are available to all templates
   # by default.

actionpack/lib/action_controller/metal/live.rb

@@ -5,7 +5,7 @@
 require "active_support/json"
 
 module ActionController
-  # = Action  Controller \Live
+  # = Action Controller \Live
   #
   # Mix this module into your controller, and all actions in that controller
   # will be able to stream data to the client as it's written.
@@ -66,6 +66,8 @@ def make_response!(request)
       end
     end
 
+    # = Action Controller \Live Server Sent Events
+    #
     # This class provides the ability to write an SSE (Server Sent Event)
     # to an IO stream. The class is initialized with a stream and can be used
     # to either write a JSON string or an object which can be converted to JSON.

actionpack/lib/action_controller/metal/strong_parameters.rb

@@ -71,7 +71,7 @@ def initialize # :nodoc:
   class InvalidParameterKey < ArgumentError
   end
 
-  # == Action Controller \Parameters
+  # = Action Controller \Parameters
   #
   # Allows you to choose which attributes should be permitted for mass updating
   # and thus prevent accidentally exposing that which shouldn't be exposed.
@@ -1177,7 +1177,7 @@ def initialize_copy(source)
       end
   end
 
-  # == Strong \Parameters
+  # = Strong \Parameters
   #
   # It provides an interface for protecting attributes from end-user
   # assignment. This makes Action Controller parameters forbidden

actionpack/lib/action_controller/test_case.rb

@@ -232,6 +232,8 @@ def load!
       end
   end
 
+  # = Action Controller Test Case
+  #
   # Superclass for ActionController functional tests. Functional tests allow you to
   # test a single controller action per test method.
   #