mirror of https://gitee.com/openkylin/peony.git
43 lines
2.4 KiB
Markdown
43 lines
2.4 KiB
Markdown
# Peony contribution guide
|
|
## Introduction
|
|
If you are reading this page, you might volunteer to be a contributor of this project. There are some suggestions from me.
|
|
|
|
## Your role(s)
|
|
What role do you want to play in this project? This point is very important.
|
|
|
|
- If you just find the problem and report a bug, you should be a user of Peony.
|
|
|
|
- If you are good at one or more foreign languages, you should be a translator.
|
|
|
|
- If you are familiar with the framework and developing on it, you should be a developer or programer of Peony.
|
|
|
|
The different character's contribution is equally important. But the threshold is different.
|
|
|
|
You need to choose your role(s) based on your own situation.
|
|
|
|
## Start with an issue
|
|
If you are a new commer, I suggest you start by emitting an issue. I can get to know you from the issue you submitted, and there's no "risk" in emitting a issue.
|
|
|
|
## Translators are in short supply
|
|
Peony is an i18n project, and it is shamed that I only studied Chinese and English. If you are familiar with English and proficient in other languages, I hope you can help me with the internationalization of the project.
|
|
|
|
## Pull request will be treated with caution
|
|
I need to think carefully about your PR. If your idea doesn't agree with mine or I find a problem during my code review, I may refuse your request or ask you to modify it.
|
|
|
|
I hope you can do a lot of verification on your work, because this is the code outside my scope, and when the two are combined, I need to be responsible for it. I don't want to let the contribution become a burden due to negligence.
|
|
|
|
A pull request can also start with a issue, that might be more well founded and friendly.
|
|
|
|
## Document and verification
|
|
It also makes sense to write new documents and verify existing documents. A good document can reflect your contribution level, and the verification of documents reflects your focus. Even though they may not contribute directly to the project, they are still very important.
|
|
|
|
## Communication
|
|
If you have question about the project, just emit an issue for help. I will try my best to answer your questions.
|
|
|
|
You also can use e-mail contract with me, here is my e-mail address:
|
|
|
|
> lanyue@kylinos.cn
|
|
|
|
## More encouragement, less demeaning
|
|
It's not easy to make a good project, especially an open source project. I hope that you can respect these labor achievements. If there's something bad to do, it should not be pointed out in a derogatory way, but like the suggestions given in the article.
|