Add clearer slate support in README. Reorganize slate_example.mustache for cleaner pages.

Author: E1337Kat

README.md

@@ -276,6 +276,7 @@ end
 * **markdown**: Generates an index file and example files in Markdown.
 * **api_blueprint**: Generates an index file and example files in [APIBlueprint](https://apiblueprint.org).
 * **append_json**: Lets you selectively run specs without destroying current documentation. See section below.
+* **slate**: Builds markdown files that can be used with [Slate](https://github.com/lord/slate), a beautiful static documentation builder.
 * **open_api**: Generates [OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md) (OAS) (Current supported version is 2.0). Can be used for [Swagger-UI](https://swagger.io/tools/swagger-ui/) 
 
 ### append_json

templates/rspec_api_documentation/slate_example.mustache

@@ -6,79 +6,73 @@
 
 ### Request
 
+{{# curl }}
+```shell
+{{{ curl }}}
+```
+{{/ curl }}
+
 #### Endpoint
 
+`{{ http_method }} {{ route }}`
+
 {{# requests}}
 ```plaintext
 {{ request_method }} {{ request_path }}
 {{ request_headers_text }}
 ```
 {{/ requests}}
 
-`{{ http_method }} {{ route }}`
-
 #### Parameters
 
 {{# requests}}
 {{# request_query_parameters_text }}
-
 ```json
 {{ request_query_parameters_text }}
 ```
 {{/ request_query_parameters_text }}
-{{# request_body }}
 
+{{# request_body }}
 ```json
 {{{ request_body }}}
 ```
 {{/ request_body }}
 
 {{# has_parameters? }}
-
 | Name | Description |
 |:-----|:------------|
 {{# parameters }}
 | {{#scope}}{{scope}}[{{/scope}}{{ name }}{{#scope}}]{{/scope}} {{# required }}*required*{{/ required }} | {{{ description }}} |
 {{/ parameters }}
-
 {{/ has_parameters? }}
 {{^ has_parameters? }}
 None known.
 {{/ has_parameters? }}
 
-{{# response_status}}
-
 ### Response
 
+
+{{# response_status}}
 ```plaintext
 {{ response_headers_text }}
 {{ response_status }} {{ response_status_text}}
 ```
 
 {{# response_body}}
-
 ```json
 {{{ response_body }}}
 ```
 {{/response_body}}
-
 {{/ response_status}}
 
-{{# has_response_fields? }}
 
+{{# has_response_fields? }}
 #### Fields
 
 | Name       | Description         |
 |:-----------|:--------------------|
 {{# response_fields }}
 | {{#scope}}{{scope}}[{{/scope}}{{ name }}{{#scope}}]{{/scope}} | {{{ description }}} |
 {{/ response_fields }}
-
 {{/ has_response_fields? }}
-
-{{# curl }}
-```shell
-{{{ curl }}}
-```
-{{/ curl }}
 {{/ requests}}

templates/rspec_api_documentation/slate_index.mustache

@@ -1,7 +1,6 @@
 ---
 title: {{ api_name }}
 language_tabs:
-  - json: JSON
   - shell: cURL
 ---