Check it live at: http://ota-doc.weekendesk.com/

You're going to need:

• Linux or OS X — Windows may work, but is unsupported.
• Ruby, version 2.3.1 or newer.
• Bundler — If Ruby is already installed, but the bundle command doesn't work, just run gem install bundler in a terminal.

1. Clone this repository.
2. cd OTA-API-Developer-Guide
3. Initialize and start Slate. You can either do this locally, or with Vagrant:

# either run this to run locally
bundle install
bundle exec middleman server

# OR run this to run with vagrant
vagrant up

You can now see the docs at http://localhost:4567. Whoa! That was fast!

Now that OTA-API-Developer-Guide is all set up on your machine, you'll probably want to learn more about editing Slate markdown, or how to publish your docs.

Prerequisites: Docker and Docker Compose

• Download this repository.

• Run the following command line on the terminal:

  docker-compose up
  

• Go to localhost:4567 to see the documentation.

• Open your file editor of preference.
• Edit the files within the source folder.
• Reload the page.

• Upload the generated files to the gh-pages branch.
• After that github will upload automatically the changes to the public domain

Make sure your changes are merged into master, then run:

./deploy-arm64.sh

This script builds the documentation site inside a Docker container (required for compatibility with arm64 Macs) and publishes the generated files to the gh-pages branch, which GitHub Pages serves as the public site at ota-doc.weekendesk.com.

Prerequisites: Docker Desktop must be running.