System specs: Note on Capybara

Author: olleolleolle

features/system_specs/system_specs.feature

@@ -3,17 +3,21 @@ Feature: System spec
     System specs are RSpec's wrapper around Rails' own
     [system tests](https://guides.rubyonrails.org/testing.html#system-testing).
 
-    Feature specs are marked by `:type => :system` or if you have set
+    > System tests allow you to test user interactions with your application,
+    > running tests in either a real or a headless browser. System tests use
+    > Capybara under the hood.
+    >
+    > By default, system tests are run with the Selenium driver, using the
+    > Chrome browser, and a screen size of 1400x1400. The next section explains
+    > how to change the default settings.
+
+    System specs are marked by `:type => :system` or if you have set
     `config.infer_spec_type_from_file_location!` by placing them in
     `spec/system`.
 
-    System tests allow you to test user interactions with your application,
-    running tests in either a real or a headless browser. System tests use
-    Capybara under the hood.
-
-    By default, system tests are run with the Selenium driver, using the Chrome
-    browser, and a screen size of 1400x1400. The next section explains how to
-    change the default settings.
+    The Capybara gem is automatically required, so you need that in your
+    Gemfile. Configure a webserver (e.g. `Capybara.server = :webrick`) before
+    attempting to use system specs.
 
     RSpec **does not** use your `ApplicationSystemTestCase` helper. Instead it
     uses the default `driven_by(:selenium)` from Rails. If you want to override