Include API explanation in Slate template

Author: Leonard Chin

features/slate_documentation.feature

@@ -49,7 +49,7 @@ Feature: Generate Slate documentation from test examples
       RspecApiDocumentation.configure do |config|
         config.app = App
         config.api_name = "Example API"
-        config.api_explanation = "Description"
+        config.api_explanation = "An explanation of the API"
         config.format = :slate
         config.curl_host = 'http://localhost:3000'
         config.request_headers_to_include = %w[Content-Type Host]
@@ -293,3 +293,9 @@ Feature: Generate Slate documentation from test examples
     """
     ## Getting welcome message
     """
+
+  Scenario: API explanation should be included
+    Then the file "doc/api/index.html.md" should contain:
+    """
+    An explanation of the API
+    """

lib/rspec_api_documentation/writers/slate_writer.rb

@@ -28,6 +28,8 @@ def write
           file.write %Q{  - shell: cURL\n}
           file.write %Q{---\n\n}
 
+          file.write configuration.api_explanation if configuration.api_explanation
+
           IndexHelper.sections(index.examples, @configuration).each do |section|
 
             file.write "# #{section[:resource_name]}\n\n"