fix review comments

docs/modules/ROOT/pages/cops_lint.adoc

@@ -2368,8 +2368,23 @@ p [''.frozen?, ''.encoding] #=> [true, #<Encoding:US-ASCII>]
 | -
 |===
 
+This cops looks for out of range referencing for Regexp, as while capturing groups out of
+out of range reference always returns nil.
+
+=== Examples
+
+[source,ruby]
+----
+/(foo)bar/ =~ 'foobar'
+
+# bad - always returns nil
+
+puts $2 # => nil
+
 # good
-  puts $1 # => foo
+
+puts $1 # => foo
+----
 
 == Lint/ParenthesesAsGroupedExpression
 

lib/rubocop/cop/lint/out_of_range_regexp_ref.rb

@@ -5,14 +5,17 @@ module Cop
     module Lint
       # This cops looks for out of range referencing for Regexp, as while capturing groups out of
       # out of range reference always returns nil.
-
+      #
       # @example
+      #
       #   /(foo)bar/ =~ 'foobar'
-
+      #
       #   # bad - always returns nil
+      #
       #   puts $2 # => nil
-
+      #
       #   # good
+      #
       #   puts $1 # => foo
       #
       class OutOfRangeRegexpRef < Base