# Contributing

Thanks for looking. Everything you need is in [docs/development.md](docs/development.md):
how to run the tests (`scripts/test.sh`), the conventions the code follows, how to
add a provider, and how a release is cut. [docs/architecture.md](docs/architecture.md)
maps the pieces.

In short:

- Run `scripts/test.sh` before you send anything; add a test for what you change,
  and check that it fails without your change.
- Never test by switching your own machine — the tests run in a sandbox for a
  reason.
- A new provider is usually a `providers.json` entry and a preset, not code.
- Keep the POSIX port bash 3.2 compatible and the PowerShell ASCII-only and 5.1
  compatible.

By contributing you agree your work is licensed under the [MIT licence](LICENSE).