Merge pull request rails#48142 from p8/actiontext/document-actiontext-content

Some cleanups for ActionText documentation [ci-skip]

Author: p8

actiontext/lib/action_text/attachable.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module ActionText
-  # = Action Text Attachable
+  # = Action Text \Attachable
   #
   # Include this module to make a record attachable to an <tt>ActionText::Content</tt>.
   #

actiontext/lib/action_text/content.rb

@@ -53,7 +53,7 @@ def links
       @links ||= fragment.find_all("a[href]").map { |a| a["href"] }.uniq
     end
 
-    # Extracts ActionText::Attachments from the HTML fragment:
+    # Extracts <tt>ActionText::Attachment</tt>s from the HTML fragment:
     #
     #   attachable = ActiveStorage::Blob.first
     #   html = %Q(<action-text-attachment sgid="#{attachable.attachable_sgid}" caption="Captioned"></action-text-attachment>)
@@ -75,12 +75,12 @@ def gallery_attachments
       @gallery_attachments ||= attachment_galleries.flat_map(&:attachments)
     end
 
-    # Extracts ActionText::Attachables from the HTML fragment:
+    # Extracts <tt>ActionText::Attachable</tt>s from the HTML fragment:
     #
     #   attachable = ActiveStorage::Blob.first
     #   html = %Q(<action-text-attachment sgid="#{attachable.attachable_sgid}" caption="Captioned"></action-text-attachment>)
     #   content = ActionText::Content.new(html)
-    #   content.attachables # => [#<ActiveStorage::Blob...
+    #   content.attachables # => [attachable]
     def attachables
       @attachables ||= attachment_nodes.map do |node|
         ActionText::Attachable.from_node(node)