lib/rubocop/cop/rspec/dialect.rb in rubocop-rspec-2.31.0 vs lib/rubocop/cop/rspec/dialect.rb in rubocop-rspec-3.0.0.pre

@@ -27,9 +27,22 @@
       #
       #   RSpec/Dialect:
       #     PreferredMethods:
       #       context: describe
       #
+      # If you were previously using the `RSpec/Capybara/FeatureMethods` cop and
+      # want to keep disabling all Capybara-specific methods that have the same
+      # native RSpec method (e.g. are just aliases), use the following config:
+      #
+      #   RSpec/Dialect:
+      #     PreferredMethods:
+      #       background: :before
+      #       scenario:   :it
+      #       xscenario:  :xit
+      #       given:      :let
+      #       given!:     :let!
+      #       feature:    :describe
+      #
       # You can expect the following behavior:
       #
       # @example
       #   # bad
       #   context 'display name presence' do