Buildkite Documentation

The source files for the Buildkite Documentation.

To contribute simply send a pull request! ❤️

Development

git clone https://github.com/buildkite/docs.git
git submodule update --init

If you have Ruby installed:

# Install the dependencies
bundle
# Run the specs
bundle exec rspec
# Start the app on http://localhost:3000/
bin/rails server

Or if you have Docker installed:

# Run the specs
docker-compose run app bundle exec rspec
# Start the app on http://localhost:3000/
docker-compose up --build
# To start it in production mode on http://localhost:3000/
docker-compose -f docker-compose.production.yml up --build

Linting

We spell-check the docs (American English) and run a few automated checks for repeated words and other common errors.

If you've added a new valid word that showing up as a spelling error, add it to vale/vocab.txt.

Search index

The search index is updated once a day by a scheduled build using the config in config/algolia.json. To test changes to the indexing configuration (you'll need an API key) run rake update_test_index.

License

See LICENSE.md (MIT)