Merge pull request rails#47830 from p8/docs/headers-action-cable

Add missing headers to Action Cable docs [ci-skip]

Author: p8

actioncable/lib/action_cable/channel/base.rb

@@ -6,6 +6,8 @@
 
 module ActionCable
   module Channel
+    # = Action Cable \Channel \Base
+    #
     # The channel provides the basic structure of grouping behavior into logical units when communicating over the WebSocket connection.
     # You can think of a channel like a form of controller, but one that's capable of pushing content to the subscriber in addition to simply
     # responding to the subscriber's direct requests.

actioncable/lib/action_cable/channel/streams.rb

@@ -2,6 +2,8 @@
 
 module ActionCable
   module Channel
+    # = Action Cable \Channel \Streams
+    #
     # Streams allow channels to route broadcastings to the subscriber. A broadcasting is, as discussed elsewhere, a pubsub queue where any data
     # placed into it is automatically sent to the clients that are connected at that time. It's purely an online queue, though. If you're not
     # streaming a broadcasting at the very moment it sends out an update, you will not get that update, even if you connect after it has been sent.

actioncable/lib/action_cable/connection/base.rb

@@ -5,6 +5,8 @@
 
 module ActionCable
   module Connection
+    # = Action Cable \Connection \Base
+    #
     # For every WebSocket connection the Action Cable server accepts, a Connection object will be instantiated. This instance becomes the parent
     # of all of the channel subscriptions that are created from there on. Incoming messages are then routed to these channel subscriptions
     # based on an identifier sent by the Action Cable consumer. The Connection itself does not deal with any specific application logic beyond

actioncable/lib/action_cable/connection/internal_channel.rb

@@ -2,6 +2,8 @@
 
 module ActionCable
   module Connection
+    # = Action Cable \InternalChannel
+    #
     # Makes it possible for the RemoteConnection to disconnect a specific connection.
     module InternalChannel
       extend ActiveSupport::Concern

actioncable/lib/action_cable/connection/subscriptions.rb

@@ -4,6 +4,8 @@
 
 module ActionCable
   module Connection
+    # = Action Cable \Connection \Subscriptions
+    #
     # Collection class for all the channel subscriptions established on a given connection. Responsible for routing incoming commands that arrive on
     # the connection to the proper channel.
     class Subscriptions # :nodoc:

actioncable/lib/action_cable/connection/tagged_logger_proxy.rb

@@ -2,6 +2,8 @@
 
 module ActionCable
   module Connection
+    # = Action Cable \Connection \TaggedLoggerProxy
+    #
     # Allows the use of per-connection tags against the server logger. This wouldn't work using the traditional
     # ActiveSupport::TaggedLogging enhanced Rails.logger, as that logger will reset the tags between requests.
     # The connection is long-lived, so it needs its own set of tags for its independent duration.

actioncable/lib/action_cable/connection/test_case.rb

@@ -56,6 +56,8 @@ def initialize(request)
       end
     end
 
+    # = Action Cable \Connection \TestCase
+    #
     # Unit test Action Cable connections.
     #
     # Useful to check whether a connection's +identified_by+ gets assigned properly
@@ -116,7 +118,7 @@ def initialize(request)
     #     assert_equal "1", connection.user_id
     #   end
     #
-    # == Connection is automatically inferred
+    # == \Connection is automatically inferred
     #
     # ActionCable::Connection::TestCase will automatically infer the connection under test
     # from the test class name. If the channel cannot be inferred from the test

actioncable/lib/action_cable/connection/web_socket.rb

@@ -4,6 +4,8 @@
 
 module ActionCable
   module Connection
+    # = Action Cable \Connection \WebSocket
+    #
     # Wrap the real socket to minimize the externally-presented API
     class WebSocket # :nodoc:
       def initialize(env, event_target, event_loop, protocols: ActionCable::INTERNAL[:protocols])

actioncable/lib/action_cable/server/base.rb

@@ -4,6 +4,8 @@
 
 module ActionCable
   module Server
+    # = Action Cable \Server \Base
+    #
     # A singleton ActionCable::Server instance is available via ActionCable.server. It's used by the Rack process that starts the Action Cable server, but
     # is also used by the user to reach the RemoteConnections object, which is used for finding and disconnecting connections across all servers.
     #

actioncable/lib/action_cable/server/broadcasting.rb

@@ -2,6 +2,8 @@
 
 module ActionCable
   module Server
+    # = Action Cable \Server \Broadcasting
+    #
     # Broadcasting is how other parts of your application can send messages to a channel's subscribers. As explained in Channel, most of the time, these
     # broadcastings are streamed directly to the clients subscribed to the named broadcasting. Let's explain with a full-stack example:
     #