Merge pull request #46 from splitwise/openapi

Switch to OpenAPI v3 + redoc

Author: jas14

CHANGELOG.md

@@ -8,6 +8,19 @@ If something in the API is confusing you, you can open an [issue](https://github
 
 If you spot an issue in our API documentation itself, feel free to open a [pull request](https://github.com/splitwise/api-docs/pulls) to update this repo! Most of the relevant files live in the [/source/includes](https://github.com/splitwise/api-docs/tree/master/source/includes) directory.
 
-## Powered by Slate
+## Powered by OpenAPI + redocly
 
-These API docs were built with [Slate](https://github.com/lord/slate). If you're looking to build an API documentation page for your own app, we'd highly recommend it 🙂
+These API docs follow the [OpenAPI v3](https://swagger.io/specification/) specification. The website is built with [redoc](https://github.com/Redocly/redoc).
+
+### Developing
+```
+$ npm install -g redoc-cli
+$ redoc-cli serve splitwise.yaml --watch
+```
+
+### Compiling
+This will create a zero-dependency HTML file at docs/index.html.
+
+```
+$ redoc-cli bundle splitwise.yaml -o docs/
+```