The example above was created with Slate. Check it out at lord.github.io/slate.
This is a template for 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.
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-api-documentation-template.git && cd revere-api-documentation-template
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 <docker app name from docker ps> bundle exec middleman build --clean