Include resource explanations in Slate output

Author: Leonard Chin

features/slate_documentation.feature

@@ -57,6 +57,7 @@ Feature: Generate Slate documentation from test examples
       end
 
       resource 'Orders' do
+        explanation "An Order represents an amount of money to be paid"
         get '/orders' do
           response_field :page, "Current page"
 
@@ -216,6 +217,7 @@ Feature: Generate Slate documentation from test examples
 
     ## Creating an order
 
+    An Order represents an amount of money to be paid
 
     ### Request
 

lib/rspec_api_documentation/writers/slate_writer.rb

@@ -26,6 +26,7 @@ def write
           IndexHelper.sections(index.examples, @configuration).each do |section|
 
             file.write "# #{section[:resource_name]}\n\n"
+            file.write "#{section[:resource_explanation]}\n\n"
             section[:examples].sort_by!(&:description) unless configuration.keep_source_order
 
             section[:examples].each do |example|