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.
Issue
You can submit a issue of the problem you encountered, your suggestion and the capability you need. Steps are as follows:
- Click
New issue
at the issue interface to create a new issue. - Select the kind of the issue and
Get started
. - Fill the title of the issue and the content of the given issue template.
- Finally
Submit new issue
.
Pull Request
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.
- Click
New pull request
at the pull request interface and select your branch to merge. - Click
Create pull request
and fill the content of the given pull request template. - Finally click
Create pull request
to 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 approve
.
Review
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.
- Click
Files changed
to check what change the pull request introduced. - Click
+
at the left of the code line and leave your comment. At the first time, you need to clickStart a review
, and later you can clickAdd review comment
. - Click
Finish your review
on the top right andSubmit review
.
Then you can just wait for the reply from the author of this pull request.
At Last
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.