# Contributing

Thank you for considering contributing to Cucumber ci-environment!

Please read [cucumber/.github/CONTRIBUTING.md](https://github.com/cucumber/.github/blob/main/CONTRIBUTING.md) first.

# Adding support for new CI servers

If you want to see support for a new CI server, please submit a pull request.

Here are the steps:

* Add a new entry to `CiEnvironments.json`.
  See [ARCHITECTURE.md](./ARCHITECTURE.md#ci-definitions) for more information on
  `CiEnvironments.json`.
* Add an approval test in `testdata/YourCi.txt` and `testdata/YourCi.txt.json`.

* Copy the `CiEnvironments.json` to the other projects by running `make copy-ci-environment`.

Then build and run the tests for all implementations:

    cd java && mvn clean install
    cd ../javascript && npm install && npm test
    cd ../ruby && bundle && bundle exec rake

If all tests pass, commit your code and submit a pull request. Bonus points if you
also update `CHANGELOG.md` and `README.md`.

You might want to look at the source code for [danger](https://github.com/danger/danger/tree/master/lib/danger/ci_source)
to understand how various CI server environment variables should be interpreted.