Skip to content

Commit

Permalink
add contributing readme
Browse files Browse the repository at this point in the history
  • Loading branch information
pbeukema committed Jul 13, 2023
1 parent a3f59de commit 7f7a30d
Showing 1 changed file with 55 additions and 0 deletions.
55 changes: 55 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# Contributing

We want to make contributing to this project as easy and transparent as possible.

## Issues

Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. The recommended issue format is:

---

#### To Reproduce

`How to reproduce the issue.`

#### Expected behavior

`Expected output.`

#### Environment

`Your environment.`

---

## Developer environment

Test project:

```bash
pytest .
```

Lint project:
Linting is required for PRs. Lint via ruff or use the provided pre commit hooks.

### Precommit hooks

Hooks can be installed from .pre-commit-config.yaml. For example:

1. `$ pip install pre-commit`
2. `$ pre-commit install`

## Pull Requests

We actively welcome your pull requests.

1. Fork the repo and create your branch from `main`.
2. If you've changed APIs, update the documentation.
3. Ensure the test suite passes (`pytest`). These are also required for PRs.
4. Make sure your code lints (`ruff`). This is also required for PRs.

## Coding Style

We use
[![Code style: ruff](https://github.com/astral-sh/ruff)](https://github.com/astral-sh/ruff)

0 comments on commit 7f7a30d

Please sign in to comment.