Files
spring-restdocs/samples/rest-notes-slate
Andy Wilkinson 41d537d06a Raise the minimum supported version of Spring Framework to 5.0
This commit upgrades to Spring Framework 5.0.0.RC1. It also upgrades
the Spring Boot-based samples to use Spring Boot 2.0.0.M1 which
supports Spring Framework 5. Lastly, it upgrades a number of
third-party dependencies to align with Spring Framework 5 and Spring
Boot 2.

Closes gh-386
2017-05-18 16:46:03 +02:00
..
2017-03-04 22:13:46 +00:00
2017-03-04 21:43:12 +00:00

REST Notes Slate

This sample shows how to document a RESTful API using Spring REST Docs and Slate. The sample can be built with Gradle, but requires Ruby and the bundler gem to be installed.

Quickstart

./gradlew build
open build/docs/api-guide.html

Details

The bulk of the documentation is written in Markdown in the file named slate/api-guide.md.erb. When the documentation is built, snippets generated by Spring REST Docs in the ApiDocumentation tests are incorporated into this documentation by ERB. The combined Markdown document is then turned into HTML.