This repository contains the code behind https://developer.bring.com/
The plugin reads a RAML->HTML map from config and outputs HTML files accordingly. RAML 0.8 has a couple of quirks, for example it doesn't have support for multiple examples, resulting in neat hacks here and there to string the page together. We're hoping to migrate to the newly launched RAML 1.0 spec soon.
Jekyll can serve the site locally and auto-watch for changes:
brew install node bundle install bundle exec rake serve # or if you want to run for a specific environment: bundle exec rake serve[<env>] # test, qa, or production
This will clean the build, install necessary SASS dependencies and launch the site at http://127.0.0.1:4000/
Release and deploy
Merging will automatically build and deploy to test, QA and production.
You can still build it (populate the
_site dir) manually by running
bundle exec rake build # or if you want to build for a specific environment: bundle exec rake build[<env>] # test, qa, or production
and then deploy as normal with
b deploy [test|qa|production]