# Contributing to this repository

First of all, thanks for taking the time to read this document and contributing to our codebase!

## Getting started

If you're working on an existing issue then awesome! Let us know by dropping a comment in the issue.

If it's a new bug fix or feature that you would like to contribute, then please raise an issue so it can be tracked (and to help out others who are experiencing the same issue / want the new thing know that it's being looked at!). Be sure to check for existing issues before raising your own!

## Working on your feature

### Branching

On this project we follow mainline development (or trunk based development), and our default branch is `main`.

Therefore you need to branch from `main` and merge into `main`.

### Coding style

Generally try to match the style and conventions of the code around your changes. Ultimately we want code that is clear, concise, consistent and easy to read.

We use `eslint` and `prettier` for linting. You can check and correct the code style using the following commands:

```console
# Check linting
yarn lint

# Fix linting
yarn lint:fix
```

### Tests

Before opening a PR, please run the following command to make sure your branch will build and pass all the checks and tests:

```console
yarn test
```

## Opening a PR

Once you're confident your branch is ready to review, open a PR against `main` on this repo.

Please use the PR template as a guide, but if your change doesn't quite fit it, feel free to customize.

## Merging and publishing

When your feature branch / PR has been tested and has an approval, it is then ready to merge. Please contact a maintainer to action the merge.