Add documentation intro to example for `Object#itself`.

Also moved comment for removal above `unless()` to not confuse RDoc with
the documentation for this method.

1 files changed, 5 insertions, 2 deletions

diff --git a/activesupport/lib/active_support/core_ext/object/itself.rb b/activesupport/lib/active_support/core_ext/object/itself.rb
index adedc20169..d71cea6674 100644
--- a/activesupport/lib/active_support/core_ext/object/itself.rb
+++ b/activesupport/lib/active_support/core_ext/object/itself.rb
@@ -1,6 +1,9 @@
 class Object
-  unless respond_to?(:itself) # TODO: Remove this file when we drop support for Ruby < 2.2
-    # Returns the object itself. Useful when dealing with a chaining scenario, like Active Record scopes:
+  # TODO: Remove this file when we drop support for Ruby < 2.2
+  unless respond_to?(:itself)
+    # Returns the object itself.
+    #
+    # Useful for chaining methods, such as Active Record scopes:
     #
     #   Event.public_send(state.presence_in([ :trashed, :drafted ]) || :itself).order(:created_at)
     #