CONTRIBUTING.md 1.9 KB
Newer Older
1 2 3
## How To Contribute

We are always very happy to have contributions, whether for trivial cleanups or big new features.
4
We want to have high quality, well documented codes for each programming language, as well as the surrounding [ecosystem](https://github.com/apache/rocketmq-externals) of integration tools that people use with RocketMQ.
5

V
vongosling 已提交
6
Nor is code the only way to contribute to the project. We strongly value documentation, integration with other project, and gladly accept improvements for these aspects.
7 8 9 10

## Contributing code

To submit a change for inclusion, please do the following:
11 12

#### If the change is non-trivial please include some unit tests that cover the new functionality.
13
#### If you are introducing a completely new feature or API it is a good idea to start a [RIP](https://github.com/apache/rocketmq/wiki/RocketMQ-Improvement-Proposal) and get consensus on the basic design first.
14
#### It is our job to follow up on patches in a timely fashion. Nag us if we aren't doing our job (sometimes we drop things).
15 16 17

## Becoming a Committer

V
vongosling 已提交
18 19 20 21 22
We are always interested in adding new contributors. What we look for are series of contributions, good taste and ongoing interest in the project. If you are interested in becoming a committer, please let one of the existing committers know and they can help you walk through the process.

Nowadays,we have several important contribution points:
#### Wiki & JavaDoc
#### RocketMQ SDK(C++\.Net\Php\Python\Go\Node.js)
23
#### RocketMQ Connectors
V
vongosling 已提交
24 25 26 27 28 29

##### Prerequisite
If you want to contribute the above listing points, you must abide our some prerequisites:

###### Readability - API must have Javadoc,some very important methods also must have javadoc
###### Testability - 80% above unit test coverage about main process
30
###### Maintainability - Comply with our [checkstyle spec](style/rmq_checkstyle.xml), and at least 3 month update frequency
V
vongosling 已提交
31
###### Deployability - We encourage you to deploy into [maven repository](http://search.maven.org/)