Merge pull request #51239 from jherdman/tweak-tag-helper-docs [ci-skip]

More complicated tag helper example

actionview/lib/action_view/helpers/tag_helper.rb

@@ -420,6 +420,14 @@ def method_missing(called, *args, escape: true, **options, &block)
       #   # A void element:
       #   tag.br  # => <br>
       #
+      # Note that when using the block form options should be wrapped in
+      # parenthesis.
+      #
+      #   <%= tag.a(href: "/about", class: "font-bold") do %>
+      #     About the author
+      #   <% end %>
+      #   # => <a href="/about" class="font-bold">About the author</a>
+      #
       # === Building HTML attributes
       #
       # Transforms a Hash into HTML attributes, ready to be interpolated into