-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
55 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |