Files
spring-restdocs/samples/rest-notes-slate
Andy Wilkinson 81ef9f8a38 Upgrade to Gradle 4.9
Closes gh-541
2018-08-08 10:45:04 +01:00
..
2018-08-08 10:45:04 +01:00
2017-03-04 22:13:46 +00:00
2017-03-04 21:43:12 +00:00
2018-04-24 08:35:13 +01: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/source/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.