The example above was created with Slate. Check it out at lord.github.io/slate.

This is Revere Sync's API documentation for anything publicly and internally exposed in Revere. It is based on slate.

This exists to create a consistent api doc between all revere products. We can own this documentation. This one is for Revere Sync.

Please feel free to contribute and follow the development setup below! Fork this repo please!

First clone this project

git clone https://github.com/revolution-messaging/revere-sync-v2-api-docs.git && cd revere-sync-v2-api-docs

A Dockerfile, and a docker-compose files are provided for setting up and running a development environment. If you're familiar with docker you can skim over the details.

Install docker from here for your system. You should now also have docker-compose in your command terminal.

Ensure docker is running the background on your machine then we can start the build.

docker-compose up

to start the application. Then visit localhost:4567 to ensure the application is running.

Before pushing documentation to a repository please build and commit the build folder as well. We can then pull from this folder across all documentation to get the latest updates.

To build your documentation with docker run:

docker run --rm -v $PWD:/usr/src/app/source -w /usr/src/app/source reveresyncv2apidocs_app bundle exec middleman build --clean