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.