How to Contribute
Contributions are welcome! Besides committing the code, you can also share your practice experience, ask questions you encountered in use, solve exsiting problems and improve the OpenYurt documentations in the community. All of these contributions will eventually be in the form of issue, pull request and review. This article will give an introduction of how to sumbit issus, pull request and review.
You can submit a issue of the problem you encountered, your suggestion and the capability you need. Steps are as follows:
New issueat the issue interface to create a new issue.
- Select the kind of the issue and
- Fill the title of the issue and the content of the given issue template.
Submit new issue.
Before coding, in order to avoid duplication of work, you had better to search the community to check if someone has been working on a same problem. Before submitting a Pull Request, you should check your local git repository and keep pace with the OpenYurt repo to avoid the merge conflict. In addition, you should have some knowledge of how does the OpenYurt CI Workflow work.
After committing to your forked OpenYurt repository, you can submit a pull request to the official OpenYurt repository, asking for the merge of your change. Steps are as follows:
- Push the code at your local host to your forked OpenYurt repository.
- Login the Github and enter your OpenYurt repository.
New pull requestat the pull request interface and select your branch to merge.
Create pull requestand fill the content of the given pull request template.
- Finally click
Create pull requestto submit the pull request, and you can find it at the pull request interface of OpenYurt.
In most cases, one pull request should only focus on one work, such as fixing a bug. Thus, only one commit should be contained in one pull request. You should amend your pull request if you find that there are more than one commits in it, using
git reset and
git commit at your local host. After your amending, you can push it to your forked openyurt repository through
git push(usually need to do forcely, take caution). The submitted pull request will sync with the branch you select to merge(at step 3), and no need to create a new pull request.
You should check the CI workflow after submitting your pull request and make all the check passed. Then, you just need to wait for the review and approval from community members. If the community accepts your pull request, it will be labeled as
lgtm(looks good to me) and
Review means check others' pull requests. Everyone are welcome to take part in the review work. It's simple than pull request. You can leave your comment at the code you have interest in. Steps are as follows:
- Select a pull request at the pull request interface.
Files changedto check what change the pull request introduced.
+at the left of the code line and leave your comment. At the first time, you need to click
Start a review, and later you can click
Add review comment.
Finish your reviewon the top right and
Then you can just wait for the reply from the author of this pull request.
The openyurt is the only one of the repositories under the openyurtio organization, for example the website you are browsing are mantained in openyurt.io repository. All of these repositories consist the OpenYurt. Welcome to explore capabilities of each repository and make OpenYurt better.