About this repository

This is the documentation site for Travis CI! (http://docs.travis-ci.com/)

How to contribute

Fork the repository, read the rest of this README file and make some changes. Once you're done with your changes send a pull request. Thanks!

How to check your edit before sending PR

You can inspect how your edits will be reflected by the documentation site.

Install dependencies

1. Make sure you have Ruby and RubyGems installed.

2. Install bundler:

   $ gem install bundler

3. Install application dependencies:

   $ bundle install --binstubs

Generate documentation

Run

$ ./bin/jekyll build

Run application server

You are now ready to start your documentation site, using Jekyll or Puma. For documentation edits, Jekyll is sufficient.

Starting and inspecting edits with Jekyll

1. Run Jekyll server:

   $ ./bin/jekyll serve

2. Open localhost:4000 in your browser.

Starting and inspecting edits with Puma

For more programmatical PRs (such as handling webhooks notification via POST), Puma is necessary.

1. Run Puma server:

   $ ./bin/puma

2. Open localhost:9292 in your browser.

API V2 documentation

API V2 (and 2.1) documentation is maintained in slate/source. To make changes to the API V2 docs:

1. Install the requirements in slate/Gemfile:

   bundle install
   

2. Make your changes to slate/source/index.md.

3. Build the API documentation:

   rake update_docs
   

4. Commit the changes and push to your branch.

License

Distributed under the MIT license; the same as other Travis CI projects.