Skip to content

Latest commit

 

History

History
62 lines (52 loc) · 2.5 KB

CONTRIBUTING.md

File metadata and controls

62 lines (52 loc) · 2.5 KB

Contributing to Numba-CUDA

If you are interested in contributing to Numba-CUDA, your contributions will fall into three categories:

  1. You want to report a bug, feature request, or documentation issue
    • File an issue describing what you encountered or what you want to see changed.
    • The Numba-CUDA team will evaluate the issues and triage them. If you believe the issue needs priority attention comment on the issue to notify the team.
  2. You want to propose a new Feature and implement it
    • Post about your intended feature, and we shall discuss the design and implementation.
    • Once we agree that the plan looks good, go ahead and implement it, using the code contributions guide below.
  3. You want to implement a feature or bug-fix for an outstanding issue
    • Follow the code contributions guide below.
    • If you need more context on a particular issue, please ask and we shall provide.

Code contributions

Your first issue

  1. Read the project's README.md to learn how to setup the development environment
  2. Find an issue to work on.
  3. Comment on the issue saying you are going to work on it
  4. Code! Make sure to update unit tests!
  5. When done, create your pull request
  6. Verify that CI passes all status checks. Fix if needed
  7. Wait for other developers to review your code and update code as needed
  8. Once reviewed and approved, a Numba-CUDA developer will merge your pull request

Remember, if you are unsure about anything, don't hesitate to comment on issues and ask for clarifications!

Releases

The release process for Numba-CUDA involves the following steps:

  • Open a PR to update numba_cuda/VERSION to the desired version.
  • Generate a short changelog with git log v<PREVIOUS_VERSION>..HEAD --oneline --pretty=format:"- %s"
  • Put the changelog in the version update PR description.
  • Once main is updated, tag the release:
git checkout main && git pull
git tag -a v<VERSION>
  • For the tag annotation, paste the same changelog as above, like this:
v<VERSION>

- ... (bullet points on release items)
  • Push the tag:
git push [email protected]:NVIDIA/numba-cuda.git v<VERSION>

Attribution

Portions adopted from https://github.com/pytorch/pytorch/blob/master/CONTRIBUTING.md