diff --git a/actionpack/lib/action_controller/layout.rb b/actionpack/lib/action_controller/layout.rb
index 0d0a843e33a2a..82c7180a52227 100644
--- a/actionpack/lib/action_controller/layout.rb
+++ b/actionpack/lib/action_controller/layout.rb
@@ -27,9 +27,9 @@ class << self
# With layouts, you can flip it around and have the common structure know where to insert changing content. This means
# that the header and footer are only mentioned in one place, like this:
#
- #
+ # // The header part of this layout
# <%= yield %>
- #
+ # // The footer part of this layout -->
#
# And then you have content pages that look like this:
#
@@ -38,9 +38,9 @@ class << self
# Not a word about common structures. At rendering time, the content page is computed and then inserted in the layout,
# like this:
#
- #
+ # // The header part of this layout
# hello world
- #
+ # // The footer part of this layout -->
#
# == Accessing shared variables
#
diff --git a/activesupport/lib/active_support/vendor/builder/xmlmarkup.rb b/activesupport/lib/active_support/vendor/builder/xmlmarkup.rb
index 12b6ff9828352..4cdcedb4a131d 100644
--- a/activesupport/lib/active_support/vendor/builder/xmlmarkup.rb
+++ b/activesupport/lib/active_support/vendor/builder/xmlmarkup.rb
@@ -38,7 +38,6 @@ module Builder
# xm.title("History") # History
# } #
# xm.body { #
- # xm.comment! "HI" #
# xm.h1("Header") # Header
# xm.p("paragraph") # paragraph
# } #