Rename header feature spec, line break change, avoid short sentences

Author: benoittgt

features/controller_specs/README.md

@@ -63,12 +63,11 @@ To specify outcomes, you can use:
 
 ## Headers
 
-We encourage you to use [request specs](https://relishapp.com/rspec/rspec-rails/docs/request-specs/request-spec) if you want to set headers in your call.
-If you still want to use controller specs with custom http headers you can use `request.headers`:
+We encourage you to use [request specs](https://relishapp.com/rspec/rspec-rails/docs/request-specs/request-spec) if you want to set headers in your call. If you still want to use controller specs with custom http headers you can use `request.headers`:
 
     require "rails_helper"
 
-    RSpec.describe TeamsController, :type => :controller do
+    RSpec.describe TeamsController, type: :controller do
       describe "GET index"
         it "returns a 200" do
           request.headers["Authorization"] = "foo"

features/controller_specs/headers.feature renamed to features/controller_specs/setting_request_headers.feature

@@ -1,16 +1,15 @@
-Feature: Headers
+Feature: Setting request headers
 
   We recommend you to switch to request specs instead of controller specs if you want to set
-  headers in your call.
-  If you still want to set headers in controller specs, you can use `request.headers` as
-  mentioned bellow.
+  headers in your call.  If you still want to set headers in controller specs, you can use
+  `request.headers` as mentioned bellow.
 
   Scenario: Setting a header value in a controller spec
     Given a file named "spec/controllers/application_controller_spec.rb" with:
       """ruby
       require "rails_helper"
 
-      RSpec.describe ApplicationController, :type => :controller do
+      RSpec.describe ApplicationController, type" :controller do
         controller do
           def show
             if request.headers["Authorization"] == "foo"