Create API endpoint documentation with swagger2markup

swagger2markup creates ASCIIdoc or Markdown documentation from swagger
files: https://github.com/Swagger2Markup/swagger2markup

Files in this change include a configuration for swagger2markup, and the
newly generated Markdown API documentation.

swagger2markdown-cli is documentat at
http://swagger2markup.github.io/swagger2markup/1.3.1/#_command_line_interface

Executable downloaded from:
https://jcenter.bintray.com/io/github/swagger2markup/swagger2markup-cli/1.3.1/swagger2markup-cli-1.3.1.jar

Markdown converted with:

java -jar swagger2markup-cli-1.3.1.jar convert \
    -f documentation/api-endpoints.md \
    -i documentation/hiccup-api.json \
    -c documentation/swagger.properties

HIC-101

(cherry-picked from commit 62b031fb0b33805abc734fd41f15dcc7a9be0762)

Change-Id: Iba04d850868e75a2534da61efbb58b1d28771124
2 files changed