Skip to content

Latest commit

 

History

History
35 lines (20 loc) · 1.58 KB

CONTRIBUTING.md

File metadata and controls

35 lines (20 loc) · 1.58 KB

Simple Guidelines

For all feature related work, it would be great to ask yourself the following questions before submitting a PR:

  1. Is your code correct? Proof of correctness and at least one Python side test. It is ok to test against well-known packages. Don't forget to add to requirements-test.txt if more packages need to be downloaded for tests.
  2. Are you using a lot of unwraps in your code? Are these unwraps justified? Same for unsafe code.
  3. If an additional dependency is needed, how much of it is really used? Will it bloat the package? What other features can we write with the additional dependency? I would discourage add an dependency if we are using 1 or 2 function out of that package.
  4. Everything can be discussed.

Remember to run these before committing:

  1. pre-commit. We use ruff.
  2. cargo fmt

How to get started?

Take a look at the Makefile. Set up your environment first. Then take a look at the tutorial here, and grasp the basics of maturin here.

Then find a issue/feature that you want to improve/implement!

A word on Doc, Typo related PRs

For docs and typo fix PRs, we welcome changes that:

  1. Fix actual typos and please do not open a PR for each typo.

  2. Add explanations, docstrings for previously undocumented features/code.

  3. Improve clarification for terms, explanations, docs, or docstrings.

  4. Fix actual broken UI/style components in doc/readme.

Simple stylistic change/reformatting that doesn't register any significant change in looks, or doesn't fix any previously noted problems will not be approved.

Please understand, and thank you for your time.