Alter example spec section

This has been altered to take out any open_api code. Given there
is only one example spec in the README document, my view is that it should
not be specifically open_api, but just use the most general options.
I have bumped the level of this section up by two levels, as it no longer fits
under the open_api section of the format section.

I have also taken out or re-factored instances of <response>, given
I could not understand what the code did in this instance.

I note that the example code in the repository is open_api, so there
is already an example of open_api code.

Author: Chris Drane

README.md

@@ -320,21 +320,16 @@ paths:
       hide: true
 ```
 
-#### Example of spec file
+## Example of acceptance spec file
 
 ```ruby
+  # spec/acceptance/orders_spec.rb 
   resource 'Orders' do
     explanation "Orders resource"
 
-    authentication :apiKey, :api_key, description: 'Private key for API access', name: 'HEADER_KEY'
     header "Content-Type", "application/json"
-    
-    let(:api_key) { generate_api_key }
 
     get '/orders' do
-      route_summary "This URL allows users to interact with all orders."
-      route_description "Long description."
-
       # This is manual way to describe complex parameters
       parameter :one_level_array, type: :array, items: {type: :string, enum: ['string1', 'string2']}, default: ['string1']
       parameter :two_level_array, type: :array, items: {type: :array, items: {type: :string}}
@@ -353,13 +348,11 @@ paths:
       context '200' do
         example_request 'Getting a list of orders' do
           expect(status).to eq(200)
-          expect(response_body).to eq(<response>)
         end
       end
     end
 
     put '/orders/:id' do
-      route_summary "This is used to update orders."
 
       with_options scope: :data, with_example: true do
         parameter :name, 'The order name', required: true
@@ -390,7 +383,7 @@ paths:
             }
           }
           expect(status).to eq(200)
-          expect(response_body).to eq(<response>)
+          expect(response_body).to eq(expected_response)
         end
       end