Add documentation note clarifying that on/off labels should only be customized when providing clearer context

Author: bsatarnejad

app/components/primer/alpha/toggle_switch.rb

@@ -29,8 +29,17 @@ class ToggleSwitch < Primer::Component
       # @param turbo [Boolean] Whether or not to request a turbo stream and render the response as such.
       # @param autofocus [Boolean] Whether switch should be autofocused when rendered.
       # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-      # @param on_label [String] Custom label to show when switch is ON. Defaults to On.
-      # @param off_label [String] Custom label to show when switch is OFF. Defaults to Off.
+      # @param on_label [String] Custom label to show when the switch is ON.
+      #   Defaults to On.
+      #   Only customize this label if it makes the toggle’s state more meaningful
+      #   in its specific context. For example, for a "Show images" setting,
+      #   you might use "Hide" when the switch is ON.
+      # @param off_label [String] Custom label to show when the switch is OFF.
+      #   Defaults to ("Off").
+      #   Only customize this label if it makes the toggle’s state more meaningful
+      #   in its specific context. For example, for a "Show images" setting,
+      #   you might use "Show" when the switch is OFF.
+
       def initialize(
         src: nil,
         csrf_token: nil,