The Dev Center docs are a Jekyll project. Refer to Jekyll's official docs and Using Jekyll with GitHub Pages for complete help. We give a quick start guide below.

1. Get Bundler, the Ruby dependency manager, if you don't have it already.
2. $ git clone https://github.com/iron-io/docs.git && cd docs
3. $ bundle install

1. In the project directory, run bundle exec jekyll serve
2. Open your browser to http://localhost:4000/

In the project directory, run bundle exec jekyll serve --watch. This will auto-reload as you make changes to files. TODO: not sure if --watch is required anymore?

Please submit all changes as Pull Requests.

Try not to use HTML unless it's required! Use markdown for everything if possible.

1. docker build -t jekyll .
2. docker run --rm -it -v "$PWD":/app -p 4000:4000 jekyll serve --watch --host 0.0.0.0

Note: to do a bundle update, run docker run --rm -it -v "$PWD":/app -w /app iron/ruby:dev bundle update