Skip to content
This repository has been archived by the owner on Feb 25, 2024. It is now read-only.

Latest commit

 

History

History
105 lines (69 loc) · 4.48 KB

CONTRIBUTING.md

File metadata and controls

105 lines (69 loc) · 4.48 KB

Contributing to bentoctl

Bentoctl is an open and community-driven project. Everyone is welcome to contribute.

To follow development updates and discussion, join the BentoML Slack community.

Ways to contribute

There are many ways to contribute to bentoctl.

  • Supporting new users by answering questions on the github issues tracker and the #support slack channel.

  • Report issues you're facing and "Thumbs up" on issues and feature requests that are relevant to you in BentoML's issues tracker.

  • Investigate bugs and reviewing other developer's pull requests.

  • Contributing code or documentation to the project by submitting a Github pull request.

Submitting a bug report or a feature request

We use Github issues to track all bugs and feature requests. Feel free to open an issue if you have found a bug or wish to see a new feature implemented.

Before submitting a github issue, ensure the bug was not already reported under issues or currently being addressed by other pull requests.

If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a title and clear description, as much relevant information as possible, and a code sample or an executable test case demonstrating the expected behavior that is not occurring.

Contributing Code

To avoid duplicating work, it is highly recommended to search through the issue tracker and pull requests list. If in doubt about duplicated work, or if you want to work on a non-trivial feature, it's recommended to first open an issue in the issue tracker to get some feedbacks from core developers.

One easy way to find an issue to work on is by applying the "help wanted" label in the issues list: help wanted issues.

For detailed instructions on how to develop BentoML locally and submit a 'pull request', follow the development guide.

If you are new to the bentoctl project and interested in contributing code, take a look at the Good first issues list. Resolving these issues allow you to start contributing to the project without much prior knoledge and help you get familiar with its codebase.

Documentation

Improving the documentation is no less important than improving the library. If you find a typo in the documentation, or have made improvements, do not hesitate to submit a GitHub pull request.

Issue Tracker Tags

Issue type tags:

question Any questions about the project
bug Something isn't working
enhancement Improving performance, usability, consistency
docs Documentation, tutorials, and example projects
new feature Feature requests or pull request implementing a new feature
test Improving unit test coverage, e2e test, CI or build

Tags to help new contributors:

help wanted An issue currently lacks a contributor
good first issue Good for newcomers

Tags for managing issues:

duplicated This issue or pull request already exists
stale Automatically applied when an issue went quiet for more than 60 days
merge-hold Requires further discussions before a pull request can be merged

Testing and improving test coverage

High quality testing is extremely important for bentoctl project. Currently bentoctl has only has Unit tests(tests) are running on Github Actions for every pull request. There is also a dummy Operator(tests/test-operator) that is used for testing Operator functionalities.

We expect pull requests that are introducing new features to have at least 90% test coverages. Pull requests that are fixing a bug should add a test covering the issue being fixed if possible.