Bentoctl is an open and community-driven project. Everyone is welcome to contribute.
To follow development updates and discussion, join the BentoML Slack community.
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.
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.
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.
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 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 |
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.