The Travis CI Documentation

Clone this repo:
  1. 077f818 typo fixed by Michał Rybiński · 7 months ago master
  2. 536b792 typos by Michał Rybiński · 7 months ago
  3. 0fc66b6 layout of numbered list by Michał Rybiński · 7 months ago
  4. 30c0837 linespacing fix by Michał Rybiński · 7 months ago
  5. f2ca12e ticket 38526 - remark underlining db schema differences by Michał Rybiński · 7 months ago

About this repository Build Status

This is the documentation site for Travis CI! (https://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. Either by clicking on the Netlify preview link in your Pull Request or building the docs locally.

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 and is generated at build time from source.

License

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