From ee505b438afc59b2ed9e365040804b977e7aaf66 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Tue, 13 Jun 2023 12:06:56 +0900
Subject: [PATCH 01/17] change ActiveSupport::Notification event name so it is
 included in Rails Server-Timings headers

---
 lib/view_component/instrumentation.rb     | 2 +-
 test/sandbox/test/instrumentation_test.rb | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/view_component/instrumentation.rb b/lib/view_component/instrumentation.rb
index b82eaabf6..7840e6600 100644
--- a/lib/view_component/instrumentation.rb
+++ b/lib/view_component/instrumentation.rb
@@ -10,7 +10,7 @@ def self.included(mod)
 
     def render_in(view_context, &block)
       ActiveSupport::Notifications.instrument(
-        "!render.view_component",
+        "render.view_component",
         {
           name: self.class.name,
           identifier: self.class.identifier
diff --git a/test/sandbox/test/instrumentation_test.rb b/test/sandbox/test/instrumentation_test.rb
index 7c1b4e71b..65ad22103 100644
--- a/test/sandbox/test/instrumentation_test.rb
+++ b/test/sandbox/test/instrumentation_test.rb
@@ -5,14 +5,14 @@
 class InstrumentationTest < ViewComponent::TestCase
   def test_instrumentation
     events = []
-    ActiveSupport::Notifications.subscribe("!render.view_component") do |*args|
+    ActiveSupport::Notifications.subscribe("render.view_component") do |*args|
       events << ActiveSupport::Notifications::Event.new(*args)
     end
     render_inline(InstrumentationComponent.new)
 
     assert_selector("div", text: "hello,world!")
     assert_equal(events.size, 1)
-    assert_equal(events[0].name, "!render.view_component")
+    assert_equal("render.view_component", events[0].name)
     assert_equal(events[0].payload[:name], "InstrumentationComponent")
     assert_match("app/components/instrumentation_component.rb", events[0].payload[:identifier])
   end

From fa874f55d42067a21137b08937cf6e769d5823ae Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Tue, 13 Jun 2023 16:36:20 +0900
Subject: [PATCH 02/17] Changelog update for instrumentation

---
 docs/CHANGELOG.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 77521fe91..3fcfce5a5 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -10,6 +10,9 @@ nav_order: 5
 
 ## main
 
+* BREAKING: Allow Instrumentation to be automatically included in Server-Timing headers generated by Rails. If you are currently subscribing to ActiveSupport::Notifications for `!render.view_component` please update your subscriptions to `render.view_component`.
+
+    *Travis Gaff*
 ## 3.3.0
 
 * Include InlineTemplate by default in Base. **Note:** It's no longer necessary to include `ViewComponent::InlineTemplate` to use inline templates.

From 62e02a979ae58251a796ac97277580402bdb26b5 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Tue, 13 Jun 2023 17:09:54 +0900
Subject: [PATCH 03/17] update docs for instrumentation change

---
 docs/guide/instrumentation.md | 8 +++++---
 docs/index.md                 | 1 +
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/guide/instrumentation.md b/docs/guide/instrumentation.md
index 712164adf..8fda8b552 100644
--- a/docs/guide/instrumentation.md
+++ b/docs/guide/instrumentation.md
@@ -17,12 +17,14 @@ To enable ActiveSupport notifications, use the `instrumentation_enabled` option:
 config.view_component.instrumentation_enabled = true
 ```
 
-Then subscribe to the `!render.view_component` event:
+Then subscribe to the `render.view_component` event:
 
 ```ruby
-ActiveSupport::Notifications.subscribe("!render.view_component") do |*args|
+ActiveSupport::Notifications.subscribe("render.view_component") do |*args|
   event = ActiveSupport::Notifications::Event.new(*args)
-  event.name    # => "!render.view_component"
+  event.name    # => "render.view_component"
   event.payload # => { name: "MyComponent", identifier: "/Users/mona/project/app/components/my_component.rb" }
 end
 ```
+
+On Rails 7 in the development environment or when `config.server_timing = true` is set, you can see sum total timing information in your browser's developer-tools. Find the request on the Network tab and view it's "timing" sub-tab. On most browsers server results are shown beneath the client-side data. Look for the key `render.view_component`.
\ No newline at end of file
diff --git a/docs/index.md b/docs/index.md
index 40e3c7a70..26b568441 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -195,6 +195,7 @@ ViewComponent is built by over a hundred members of the community, including:
 <img src="https://avatars.githubusercontent.com/tbroad-ramsey?s=64" alt="tbroad-ramsey" width="32" />
 <img src="https://avatars.githubusercontent.com/tclem?s=64" alt="tclem" width="32" />
 <img src="https://avatars.githubusercontent.com/tenderlove?s=64" alt="tenderlove" width="32" />
+<img src="https://avatars.githubusercontent.com/tgaff?s=64" alt="tgaff" width="32" />
 <img src="https://avatars.githubusercontent.com/thutterer?s=64" alt="thutterer" width="32" />
 <img src="https://avatars.githubusercontent.com/tonkpils?s=64" alt="tonkpils" width="32" />
 <img src="https://avatars.githubusercontent.com/traels?s=64" alt="traels" width="32" />

From 1468c16427b5d900d5fd8075b4c2f3e2c7690bf8 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Tue, 13 Jun 2023 17:39:09 +0900
Subject: [PATCH 04/17] add trailing whitespace per PR linter

---
 docs/guide/instrumentation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guide/instrumentation.md b/docs/guide/instrumentation.md
index 8fda8b552..77c9f57c7 100644
--- a/docs/guide/instrumentation.md
+++ b/docs/guide/instrumentation.md
@@ -27,4 +27,4 @@ ActiveSupport::Notifications.subscribe("render.view_component") do |*args|
 end
 ```
 
-On Rails 7 in the development environment or when `config.server_timing = true` is set, you can see sum total timing information in your browser's developer-tools. Find the request on the Network tab and view it's "timing" sub-tab. On most browsers server results are shown beneath the client-side data. Look for the key `render.view_component`.
\ No newline at end of file
+On Rails 7 in the development environment or when `config.server_timing = true` is set, you can see sum total timing information in your browser's developer-tools. Find the request on the Network tab and view it's "timing" sub-tab. On most browsers server results are shown beneath the client-side data. Look for the key `render.view_component`.

From f2a8a910be055b2b19f937995a4e4a2ac0a6c2c1 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Wed, 28 Jun 2023 16:55:47 +0900
Subject: [PATCH 05/17] Instrumentation key with '!' deprecated and usage can
 be configured

---
 lib/view_component/config.rb              |  8 ++++++++
 lib/view_component/instrumentation.rb     | 10 +++++++++-
 test/sandbox/test/config_test.rb          |  1 +
 test/sandbox/test/instrumentation_test.rb | 23 ++++++++++++++++++-----
 4 files changed, 36 insertions(+), 6 deletions(-)

diff --git a/lib/view_component/config.rb b/lib/view_component/config.rb
index 9efa61cf2..0d7615d28 100644
--- a/lib/view_component/config.rb
+++ b/lib/view_component/config.rb
@@ -17,6 +17,7 @@ def defaults
           preview_route: "/rails/view_components",
           show_previews_source: false,
           instrumentation_enabled: false,
+          instrumentation_use_deprecated_name: true,
           render_monkey_patch_enabled: true,
           view_component_path: "app/components",
           component_parent_class: nil,
@@ -99,6 +100,13 @@ def defaults
       # Whether ActiveSupport notifications are enabled.
       # Defaults to `false`.
 
+      # @!attribute instrumentation_use_deprecated_name
+      # @return [Boolean]
+      # Whether ActiveSupport Notifications use the private name "!render.view_component"
+      # or are made more publicly available via "render.view_component".
+      # Will default to false in next major version.
+      # Defaults to `true`.
+
       # @!attribute render_monkey_patch_enabled
       # @return [Boolean] Whether the #render method should be monkey patched.
       # If this is disabled, use `#render_component` or
diff --git a/lib/view_component/instrumentation.rb b/lib/view_component/instrumentation.rb
index 7840e6600..9e877ce65 100644
--- a/lib/view_component/instrumentation.rb
+++ b/lib/view_component/instrumentation.rb
@@ -10,7 +10,7 @@ def self.included(mod)
 
     def render_in(view_context, &block)
       ActiveSupport::Notifications.instrument(
-        "render.view_component",
+        notification_name,
         {
           name: self.class.name,
           identifier: self.class.identifier
@@ -19,5 +19,13 @@ def render_in(view_context, &block)
         super(view_context, &block)
       end
     end
+
+    private
+
+    def notification_name
+      return "!render.view_component" if ViewComponent::Base.config.instrumentation_use_deprecated_name
+
+      "render.view_component"
+    end
   end
 end
diff --git a/test/sandbox/test/config_test.rb b/test/sandbox/test/config_test.rb
index 62fc9dd5d..771568472 100644
--- a/test/sandbox/test/config_test.rb
+++ b/test/sandbox/test/config_test.rb
@@ -14,6 +14,7 @@ def test_defaults_are_correct
       assert_equal @config.preview_route, "/rails/view_components"
       assert_equal @config.show_previews_source, false
       assert_equal @config.instrumentation_enabled, false
+      assert_equal @config.instrumentation_use_deprecated_name, true
       assert_equal @config.render_monkey_patch_enabled, true
       assert_equal @config.show_previews, true
       assert_equal @config.preview_paths, ["#{Rails.root}/test/components/previews"]
diff --git a/test/sandbox/test/instrumentation_test.rb b/test/sandbox/test/instrumentation_test.rb
index 65ad22103..9fc2d349a 100644
--- a/test/sandbox/test/instrumentation_test.rb
+++ b/test/sandbox/test/instrumentation_test.rb
@@ -4,16 +4,29 @@
 
 class InstrumentationTest < ViewComponent::TestCase
   def test_instrumentation
+    with_config_option(:instrumentation_use_deprecated_name, false) do
+      events = []
+      ActiveSupport::Notifications.subscribe("render.view_component") do |*args|
+        events << ActiveSupport::Notifications::Event.new(*args)
+      end
+      render_inline(InstrumentationComponent.new)
+
+      assert_selector("div", text: "hello,world!")
+      assert_equal(events.size, 1)
+      assert_equal("render.view_component", events[0].name)
+      assert_equal(events[0].payload[:name], "InstrumentationComponent")
+      assert_match("app/components/instrumentation_component.rb", events[0].payload[:identifier])
+    end
+  end
+
+  def test_instrumentation_with_deprecated_name
     events = []
-    ActiveSupport::Notifications.subscribe("render.view_component") do |*args|
+    ActiveSupport::Notifications.subscribe("!render.view_component") do |*args|
       events << ActiveSupport::Notifications::Event.new(*args)
     end
     render_inline(InstrumentationComponent.new)
 
-    assert_selector("div", text: "hello,world!")
     assert_equal(events.size, 1)
-    assert_equal("render.view_component", events[0].name)
-    assert_equal(events[0].payload[:name], "InstrumentationComponent")
-    assert_match("app/components/instrumentation_component.rb", events[0].payload[:identifier])
+    assert_equal("!render.view_component", events[0].name)
   end
 end

From 4d9a5c2d544a39883b385bb3b25f060fb2709050 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Thu, 29 Jun 2023 12:22:29 +0900
Subject: [PATCH 06/17] update CHANGELOG to mention new config for
 instrumentation and deprecation

---
 docs/CHANGELOG.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 3fcfce5a5..e1acdd11b 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -10,9 +10,10 @@ nav_order: 5
 
 ## main
 
-* BREAKING: Allow Instrumentation to be automatically included in Server-Timing headers generated by Rails. If you are currently subscribing to ActiveSupport::Notifications for `!render.view_component` please update your subscriptions to `render.view_component`.
+* Allow instrumentation to be automatically included in Server-Timing headers generated by Rails. To enable this set the config `config.instrumentation_use_deprecated_name = false`.  The old key `!render.view_component` is deprecated, please update your ActiveSupport::Notification subscriptions to `render.view_component`.
 
     *Travis Gaff*
+
 ## 3.3.0
 
 * Include InlineTemplate by default in Base. **Note:** It's no longer necessary to include `ViewComponent::InlineTemplate` to use inline templates.

From 107b61074329f1c74f57709f6780215affe34589 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Thu, 29 Jun 2023 12:36:42 +0900
Subject: [PATCH 07/17] update documentation for instrumentation

---
 docs/guide/instrumentation.md | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/guide/instrumentation.md b/docs/guide/instrumentation.md
index 77c9f57c7..7cd0a9359 100644
--- a/docs/guide/instrumentation.md
+++ b/docs/guide/instrumentation.md
@@ -15,16 +15,19 @@ To enable ActiveSupport notifications, use the `instrumentation_enabled` option:
 # config/application.rb
 # Enable ActiveSupport notifications for all ViewComponents
 config.view_component.instrumentation_enabled = true
+config.view_component.instrumentation_use_deprecated_name = false
 ```
 
-Then subscribe to the `render.view_component` event:
+Setting `instrumentation_use_deprecated_name` configures the event name used.  If `false` the name `"render.view_component"` is used.  If `true` (default) it will use the deprecated name `"!render.view_component"`.
+
+You can then subscribe to the event:
 
 ```ruby
-ActiveSupport::Notifications.subscribe("render.view_component") do |*args|
+ActiveSupport::Notifications.subscribe("render.view_component") do |*args| # or !render.view_component
   event = ActiveSupport::Notifications::Event.new(*args)
   event.name    # => "render.view_component"
   event.payload # => { name: "MyComponent", identifier: "/Users/mona/project/app/components/my_component.rb" }
 end
 ```
 
-On Rails 7 in the development environment or when `config.server_timing = true` is set, you can see sum total timing information in your browser's developer-tools. Find the request on the Network tab and view it's "timing" sub-tab. On most browsers server results are shown beneath the client-side data. Look for the key `render.view_component`.
+If you're using the non-deprecated key & have `config.server_timing = true` (default in development) set in Rails 7, you can see sum total timing information in your browser's developer-tools. Find the request on the Network tab and view it's "timing" sub-tab. On most browsers server results are shown beneath the client-side data. Look for the key `render.view_component`.

From 875f6bdf6e2f964bbe0bffacf9d2d52e7edf780b Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Thu, 29 Jun 2023 13:50:29 +0900
Subject: [PATCH 08/17] send deprecation notice once, rather than on each
 render

---
 lib/view_component/engine.rb | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/lib/view_component/engine.rb b/lib/view_component/engine.rb
index 2a06142b7..c08d21020 100644
--- a/lib/view_component/engine.rb
+++ b/lib/view_component/engine.rb
@@ -2,6 +2,7 @@
 
 require "rails"
 require "view_component/config"
+require "view_component/deprecation"
 
 module ViewComponent
   class Engine < Rails::Engine # :nodoc:
@@ -42,6 +43,12 @@ class Engine < Rails::Engine # :nodoc:
           # :nocov:
           ViewComponent::Base.prepend(ViewComponent::Instrumentation)
           # :nocov:
+          if app.config.view_component.instrumentation_use_deprecated_name
+            ViewComponent::Deprecation.deprecation_warning(
+              "!render.view_component",
+              "Use the new instrumentation key `render.view_component` instead. See https://viewcomponent.org/guide/instrumentation.html"
+            )
+          end
         end
       end
     end

From 5ea279ff81d5976d5c0bd7e47a26393129c23135 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Thu, 29 Jun 2023 17:59:57 +0900
Subject: [PATCH 09/17] remove double-spaces

---
 docs/guide/instrumentation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guide/instrumentation.md b/docs/guide/instrumentation.md
index 7cd0a9359..f989e7027 100644
--- a/docs/guide/instrumentation.md
+++ b/docs/guide/instrumentation.md
@@ -18,7 +18,7 @@ config.view_component.instrumentation_enabled = true
 config.view_component.instrumentation_use_deprecated_name = false
 ```
 
-Setting `instrumentation_use_deprecated_name` configures the event name used.  If `false` the name `"render.view_component"` is used.  If `true` (default) it will use the deprecated name `"!render.view_component"`.
+Setting `instrumentation_use_deprecated_name` configures the event name used. If `false` the name `"render.view_component"` is used. If `true` (default) it will use the deprecated name `"!render.view_component"`.
 
 You can then subscribe to the event:
 

From 2158ad35d087d519de11f3d44b9b46fc1bc972aa Mon Sep 17 00:00:00 2001
From: Joel Hawksley <joelhawksley@github.com>
Date: Mon, 3 Jul 2023 17:13:44 -0600
Subject: [PATCH 10/17] Apply suggestions from code review

---
 docs/CHANGELOG.md                         | 2 +-
 docs/guide/instrumentation.md             | 8 ++++----
 lib/view_component/config.rb              | 4 ++--
 lib/view_component/instrumentation.rb     | 2 +-
 test/sandbox/test/config_test.rb          | 2 +-
 test/sandbox/test/instrumentation_test.rb | 2 +-
 6 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index e1acdd11b..72598c85b 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -10,7 +10,7 @@ nav_order: 5
 
 ## main
 
-* Allow instrumentation to be automatically included in Server-Timing headers generated by Rails. To enable this set the config `config.instrumentation_use_deprecated_name = false`.  The old key `!render.view_component` is deprecated, please update your ActiveSupport::Notification subscriptions to `render.view_component`.
+* Allow instrumentation to be automatically included in Server-Timing headers generated by Rails. To enable this set the config `config.use_deprecated_instrumentation_name = false`.  The old key `!render.view_component` is deprecated: update ActiveSupport::Notification subscriptions to `render.view_component`.
 
     *Travis Gaff*
 
diff --git a/docs/guide/instrumentation.md b/docs/guide/instrumentation.md
index f989e7027..66a50bb5f 100644
--- a/docs/guide/instrumentation.md
+++ b/docs/guide/instrumentation.md
@@ -15,12 +15,12 @@ To enable ActiveSupport notifications, use the `instrumentation_enabled` option:
 # config/application.rb
 # Enable ActiveSupport notifications for all ViewComponents
 config.view_component.instrumentation_enabled = true
-config.view_component.instrumentation_use_deprecated_name = false
+config.view_component.use_deprecated_instrumentation_name = false
 ```
 
-Setting `instrumentation_use_deprecated_name` configures the event name used. If `false` the name `"render.view_component"` is used. If `true` (default) it will use the deprecated name `"!render.view_component"`.
+Setting `use_deprecated_instrumentation_name` configures the event name. If `false` the name is `"render.view_component"`. If `true` (default) the deprecated `"!render.view_component"` will be used.
 
-You can then subscribe to the event:
+Subscribe to the event:
 
 ```ruby
 ActiveSupport::Notifications.subscribe("render.view_component") do |*args| # or !render.view_component
@@ -30,4 +30,4 @@ ActiveSupport::Notifications.subscribe("render.view_component") do |*args| # or
 end
 ```
 
-If you're using the non-deprecated key & have `config.server_timing = true` (default in development) set in Rails 7, you can see sum total timing information in your browser's developer-tools. Find the request on the Network tab and view it's "timing" sub-tab. On most browsers server results are shown beneath the client-side data. Look for the key `render.view_component`.
+When using `render.view_component` with `config.server_timing = true` (default in development) in Rails 7, the Chrome developer tools display the sum total timing information in Network > Timing under the key `render.view_component`.
diff --git a/lib/view_component/config.rb b/lib/view_component/config.rb
index 0d7615d28..3c7df6fc8 100644
--- a/lib/view_component/config.rb
+++ b/lib/view_component/config.rb
@@ -17,7 +17,7 @@ def defaults
           preview_route: "/rails/view_components",
           show_previews_source: false,
           instrumentation_enabled: false,
-          instrumentation_use_deprecated_name: true,
+          use_deprecated_instrumentation_name: true,
           render_monkey_patch_enabled: true,
           view_component_path: "app/components",
           component_parent_class: nil,
@@ -100,7 +100,7 @@ def defaults
       # Whether ActiveSupport notifications are enabled.
       # Defaults to `false`.
 
-      # @!attribute instrumentation_use_deprecated_name
+      # @!attribute use_deprecated_instrumentation_name
       # @return [Boolean]
       # Whether ActiveSupport Notifications use the private name "!render.view_component"
       # or are made more publicly available via "render.view_component".
diff --git a/lib/view_component/instrumentation.rb b/lib/view_component/instrumentation.rb
index 9e877ce65..380dea016 100644
--- a/lib/view_component/instrumentation.rb
+++ b/lib/view_component/instrumentation.rb
@@ -23,7 +23,7 @@ def render_in(view_context, &block)
     private
 
     def notification_name
-      return "!render.view_component" if ViewComponent::Base.config.instrumentation_use_deprecated_name
+      return "!render.view_component" if ViewComponent::Base.config.use_deprecated_instrumentation_name
 
       "render.view_component"
     end
diff --git a/test/sandbox/test/config_test.rb b/test/sandbox/test/config_test.rb
index 771568472..9c741ed12 100644
--- a/test/sandbox/test/config_test.rb
+++ b/test/sandbox/test/config_test.rb
@@ -14,7 +14,7 @@ def test_defaults_are_correct
       assert_equal @config.preview_route, "/rails/view_components"
       assert_equal @config.show_previews_source, false
       assert_equal @config.instrumentation_enabled, false
-      assert_equal @config.instrumentation_use_deprecated_name, true
+      assert_equal @config.use_deprecated_instrumentation_name, true
       assert_equal @config.render_monkey_patch_enabled, true
       assert_equal @config.show_previews, true
       assert_equal @config.preview_paths, ["#{Rails.root}/test/components/previews"]
diff --git a/test/sandbox/test/instrumentation_test.rb b/test/sandbox/test/instrumentation_test.rb
index 9fc2d349a..b2d4d0490 100644
--- a/test/sandbox/test/instrumentation_test.rb
+++ b/test/sandbox/test/instrumentation_test.rb
@@ -4,7 +4,7 @@
 
 class InstrumentationTest < ViewComponent::TestCase
   def test_instrumentation
-    with_config_option(:instrumentation_use_deprecated_name, false) do
+    with_config_option(:use_deprecated_instrumentation_name, false) do
       events = []
       ActiveSupport::Notifications.subscribe("render.view_component") do |*args|
         events << ActiveSupport::Notifications::Event.new(*args)

From 7bce027c54a69f03becad9bcb9bee194abc8a35f Mon Sep 17 00:00:00 2001
From: Joel Hawksley <joelhawksley@github.com>
Date: Wed, 5 Jul 2023 07:27:09 -0600
Subject: [PATCH 11/17] Update docs/guide/instrumentation.md

---
 docs/guide/instrumentation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guide/instrumentation.md b/docs/guide/instrumentation.md
index 66a50bb5f..925efe3b5 100644
--- a/docs/guide/instrumentation.md
+++ b/docs/guide/instrumentation.md
@@ -30,4 +30,4 @@ ActiveSupport::Notifications.subscribe("render.view_component") do |*args| # or
 end
 ```
 
-When using `render.view_component` with `config.server_timing = true` (default in development) in Rails 7, the Chrome developer tools display the sum total timing information in Network > Timing under the key `render.view_component`.
+When using `render.view_component` with `config.server_timing = true` (default in development) in Rails 7, the browser developer tools display the sum total timing information in Network > Timing under the key `render.view_component`.

From 9fe8dd3bbdaa16bb1cdbbe6b660f5d793119f894 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Thu, 6 Jul 2023 17:32:46 +0900
Subject: [PATCH 12/17] rename instrumentation config key to match other
 renames

  * this has no test coverage :-(
---
 lib/view_component/engine.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/view_component/engine.rb b/lib/view_component/engine.rb
index c08d21020..0d94f8e06 100644
--- a/lib/view_component/engine.rb
+++ b/lib/view_component/engine.rb
@@ -43,7 +43,7 @@ class Engine < Rails::Engine # :nodoc:
           # :nocov:
           ViewComponent::Base.prepend(ViewComponent::Instrumentation)
           # :nocov:
-          if app.config.view_component.instrumentation_use_deprecated_name
+          if app.config.view_component.use_deprecated_instrumentation_name
             ViewComponent::Deprecation.deprecation_warning(
               "!render.view_component",
               "Use the new instrumentation key `render.view_component` instead. See https://viewcomponent.org/guide/instrumentation.html"

From 1ad2f0d9d26948e316a64aaae115114aca70e278 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Fri, 7 Jul 2023 11:49:36 +0900
Subject: [PATCH 13/17] nocov initializer code: re-executing it in tests causes
 order-dependent failures

Example: instrumentation notices are doubled
---
 lib/view_component/engine.rb | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/view_component/engine.rb b/lib/view_component/engine.rb
index 0d94f8e06..4490fe343 100644
--- a/lib/view_component/engine.rb
+++ b/lib/view_component/engine.rb
@@ -40,15 +40,15 @@ class Engine < Rails::Engine # :nodoc:
         Base.config = app.config.view_component
 
         if app.config.view_component.instrumentation_enabled.present?
-          # :nocov:
+          # :nocov: Re-executing the below in a test duplicates initializers and causes order-dependent failures.
           ViewComponent::Base.prepend(ViewComponent::Instrumentation)
-          # :nocov:
           if app.config.view_component.use_deprecated_instrumentation_name
             ViewComponent::Deprecation.deprecation_warning(
               "!render.view_component",
               "Use the new instrumentation key `render.view_component` instead. See https://viewcomponent.org/guide/instrumentation.html"
             )
           end
+         # :nocov:
         end
       end
     end

From dd05dc8bb646f801509020fe9215d5ae8a265dad Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Fri, 7 Jul 2023 12:27:35 +0900
Subject: [PATCH 14/17] lint

---
 lib/view_component/engine.rb | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/view_component/engine.rb b/lib/view_component/engine.rb
index 4490fe343..4569678fb 100644
--- a/lib/view_component/engine.rb
+++ b/lib/view_component/engine.rb
@@ -40,7 +40,7 @@ class Engine < Rails::Engine # :nodoc:
         Base.config = app.config.view_component
 
         if app.config.view_component.instrumentation_enabled.present?
-          # :nocov: Re-executing the below in a test duplicates initializers and causes order-dependent failures.
+          # :nocov: Re-executing the below in tests duplicates initializers and causes order-dependent failures.
           ViewComponent::Base.prepend(ViewComponent::Instrumentation)
           if app.config.view_component.use_deprecated_instrumentation_name
             ViewComponent::Deprecation.deprecation_warning(
@@ -48,7 +48,7 @@ class Engine < Rails::Engine # :nodoc:
               "Use the new instrumentation key `render.view_component` instead. See https://viewcomponent.org/guide/instrumentation.html"
             )
           end
-         # :nocov:
+          # :nocov:
         end
       end
     end

From e4b59938bc85f3ee87c84893016812bd64d1491b Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Fri, 7 Jul 2023 15:03:53 +0900
Subject: [PATCH 15/17] docs: Add browser dev tools image to aid explanation

---
 docs/guide/instrumentation.md                   |   4 ++++
 ...nstrumentation_sums_in_browser_dev_tools.png | Bin 0 -> 26283 bytes
 2 files changed, 4 insertions(+)
 create mode 100644 docs/images/viewing_instrumentation_sums_in_browser_dev_tools.png

diff --git a/docs/guide/instrumentation.md b/docs/guide/instrumentation.md
index 925efe3b5..b84b8fd3d 100644
--- a/docs/guide/instrumentation.md
+++ b/docs/guide/instrumentation.md
@@ -30,4 +30,8 @@ ActiveSupport::Notifications.subscribe("render.view_component") do |*args| # or
 end
 ```
 
+### Viewing instrumentation sums in the browser developer tools
+
 When using `render.view_component` with `config.server_timing = true` (default in development) in Rails 7, the browser developer tools display the sum total timing information in Network > Timing under the key `render.view_component`.
+
+![Browser showing the Server Timing data in the browser dev tools](../images/viewing_instrumentation_sums_in_browser_dev_tools.png "Server Timing data in the browser dev tools")
\ No newline at end of file
diff --git a/docs/images/viewing_instrumentation_sums_in_browser_dev_tools.png b/docs/images/viewing_instrumentation_sums_in_browser_dev_tools.png
new file mode 100644
index 0000000000000000000000000000000000000000..e48906b7b851c3e28e1f5681a0568225f64087a2
GIT binary patch
literal 26283
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
Lo>V`68To$zj%YR%

literal 0
HcmV?d00001


From e570a639b80a44c81481d92c2bb4734466d29b16 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Fri, 7 Jul 2023 15:13:31 +0900
Subject: [PATCH 16/17] docs: code back-ticks to make Vale happier

---
 docs/api.md                  | 21 +++++++++++++--------
 lib/view_component/config.rb |  6 +++---
 2 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/docs/api.md b/docs/api.md
index f557e2506..fc3c916ef 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -244,6 +244,13 @@ The controller used for testing components.
 Can also be configured on a per-test basis using `#with_controller_class`.
 Defaults to `ApplicationController`.
 
+### `.use_deprecated_instrumentation_name`
+
+Whether ActiveSupport Notifications use the private name `"!render.view_component"`
+or are made more publicly available via `"render.view_component"`.
+Will default to `false` in next major version.
+Defaults to `true`.
+
 ### `.view_component_path`
 
 The path in which components, their templates, and their sidecars should
@@ -342,14 +349,6 @@ with_request_url("/users/42") do
 end
 ```
 
-To use a specific host, pass the host param:
-
-```ruby
-with_request_url("/users/42", host: "app.example.com") do
-  render_inline(MyComponent.new)
-end
-```
-
 ### `#with_variant(variant)`
 
 Set the Action Pack request variant for the given block:
@@ -362,6 +361,12 @@ end
 
 ## Errors
 
+### `AlreadyDefinedPolymorphicSlotSetterError`
+
+A method called 'SETTER_METHOD_NAME' already exists and would be overwritten by the 'SETTER_NAME' polymorphic slot setter.
+
+Please choose a different setter name.
+
 ### `ContentAlreadySetForPolymorphicSlotError`
 
 Content for slot SLOT_NAME has already been provided.
diff --git a/lib/view_component/config.rb b/lib/view_component/config.rb
index 3c7df6fc8..ce444dca4 100644
--- a/lib/view_component/config.rb
+++ b/lib/view_component/config.rb
@@ -102,9 +102,9 @@ def defaults
 
       # @!attribute use_deprecated_instrumentation_name
       # @return [Boolean]
-      # Whether ActiveSupport Notifications use the private name "!render.view_component"
-      # or are made more publicly available via "render.view_component".
-      # Will default to false in next major version.
+      # Whether ActiveSupport Notifications use the private name `"!render.view_component"`
+      # or are made more publicly available via `"render.view_component"`.
+      # Will default to `false` in next major version.
       # Defaults to `true`.
 
       # @!attribute render_monkey_patch_enabled

From 22afad045d51177bbf4d15a29d6bea262312ed61 Mon Sep 17 00:00:00 2001
From: Travis Gaff <travis@labzero.com>
Date: Fri, 7 Jul 2023 15:18:28 +0900
Subject: [PATCH 17/17] md linting

---
 docs/guide/instrumentation.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/guide/instrumentation.md b/docs/guide/instrumentation.md
index b84b8fd3d..a802d9e35 100644
--- a/docs/guide/instrumentation.md
+++ b/docs/guide/instrumentation.md
@@ -30,8 +30,8 @@ ActiveSupport::Notifications.subscribe("render.view_component") do |*args| # or
 end
 ```
 
-### Viewing instrumentation sums in the browser developer tools
+## Viewing instrumentation sums in the browser developer tools
 
 When using `render.view_component` with `config.server_timing = true` (default in development) in Rails 7, the browser developer tools display the sum total timing information in Network > Timing under the key `render.view_component`.
 
-![Browser showing the Server Timing data in the browser dev tools](../images/viewing_instrumentation_sums_in_browser_dev_tools.png "Server Timing data in the browser dev tools")
\ No newline at end of file
+![Browser showing the Server Timing data in the browser dev tools](../images/viewing_instrumentation_sums_in_browser_dev_tools.png "Server Timing data in the browser dev tools")