StarRocks is built by an open and friendly community. We are dedicated to building a collaborative, inspiring, and exuberant open-source community for our members. Everyone is more than welcome to join our community to get help and to contribute to StarRocks.
- How to contribute
- Contributing guideline
- Code of conduct
Contributions to StarRocks are cordially welcome from everyone. Contributing to StarRocks is not limited to contributing codes. Below, we list different approaches to contributing to our community.
| Contribution | Details |
|---|---|
| Report a bug | You can file an issue To report a bug with StarRock. |
| Contribute code | You can contribute your code by fixing a bug or implementing a feature. |
| Contribute test case | You can contribute your test cases. |
| Help review code | If you are an active contributor or committer of StarRocks, you can help us review the pull requests (PRs). |
| Contribute documentation | StarRocks community maintains a tremendous amount of documentation both in Chinese and English. You can contribute documentation changes by fixing a documentation bug or proposing a new piece of content. |
| Help StarRocks users | You can help newcomers who meet difficulties in our community. |
| Spread the word about StarRocks | You can author an article or give a talk about us to help us spread our technology to the world. |
This guide describes how to make various types of contribution to StarRocks community.
To report a bug with StarRocks, you should file an issue in StarRocks repository, and provide necessary information and, if possible, steps to reproduce the bug in the issue body.
You can contribute your code by fixing a bug you identified or in an existing issue. If you are new to this project, you may find the issues labelled good-first-issue suitable for your first contribution. Usually, such issues provide a detailed description of the procedure to solve the problem in its issue body.
If you are confident with your programming proficiency, you can also contribute your code by helping develop a feature for StarRocks.
Before getting your hands on codes, you should comment and mention the repository maintainer in the issue body, and inform him/her to assign to you the issue that you wish to solve. It is recommended to share your plan on how to solve this problem in the issue body as well.
In StarRocks community, we follow the fork-and-merge GitHub workflow when contributing code.
- Create a fork of StarRocks in your GitHub account.
- Clone this forked repository to your local device.
- Check out a new branch based on the branch you expect to contribute.
- Commit your code changes on the new branch.
- Push the branch with code changes to GitHub.
- Create a PR to submit your code changes.
The repository maintainers will review your code changes as soon as possible. Your commits will be merged once approved.
For detailed instruction on GitHub workflow, see StarRocks GitHub Workflow.
TBC
TBC
- For FE development environment, see The development configuration setup for StarRocks on IDEA.
- For BE development environment, see The development configuration setup for StarRocks on Clion.
TBC
TBC
- Write your commit message in English.
- Start your commit message with a verb clause initiated with an upper case letter.
- Use concise, explicit language.
- You should relate the issue you worked on in the PR body.
- It is recommended to submit ONE commit in ONE PR. See PR template for more inforamtion.
To get your PR merged, you must submit your Contributor License Agreement (CLA) first. You only need to submit it ONCE.
TBC
Whenever you have difficulties in development, you can reach out to the following members for help. You can mention them in your issue or PR.
- TBC
TBC
TBC
To contribute to StarRocks documentation, please refer to Document Contribution Guideline.
If you are a proficient StarRocks user, you can contribute to our community by helping new members solve the problems when they use StarRocks.
You are welcome to author a blog article about StarRocks in the media, or host a live broadcast to spread StarRocks to the world. Please contact opensource@starrocks.com for more information and instructions.
All members in the community are instructed to follow our Code of Conduct.