Repository: incubator-rocketmq Updated Branches: refs/heads/master 9ec7e26ed -> 8d7dd2b37
Polish the doc Project: http://git-wip-us.apache.org/repos/asf/incubator-rocketmq/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-rocketmq/commit/8d7dd2b3 Tree: http://git-wip-us.apache.org/repos/asf/incubator-rocketmq/tree/8d7dd2b3 Diff: http://git-wip-us.apache.org/repos/asf/incubator-rocketmq/diff/8d7dd2b3 Branch: refs/heads/master Commit: 8d7dd2b377a053901432f873b322197aa51a4f06 Parents: 9ec7e26 Author: vongosling <[email protected]> Authored: Wed Dec 21 22:23:56 2016 +0800 Committer: vongosling <[email protected]> Committed: Wed Dec 21 22:23:56 2016 +0800 ---------------------------------------------------------------------- CONTRIBUTING.md | 26 ++++++++++++++++++++------ README.md | 20 ++++++-------------- 2 files changed, 26 insertions(+), 20 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-rocketmq/blob/8d7dd2b3/CONTRIBUTING.md ---------------------------------------------------------------------- diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a3f3baa..f212787 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,17 +1,31 @@ ## How To Contribute We are always very happy to have contributions, whether for trivial cleanups or big new features. -We want to have high quality, well documented codes for each programming language. These, as well as the surrounding [ecosystem](https://github.com/rocketmq) of integration tools that people use with RocketMQ, are critical aspects of the project. +We want to have high quality, well documented codes for each programming language, as well as the surrounding [ecosystem](https://github.com/rocketmq) of integration tools that people use with RocketMQ. -Nor is code the only way to contribute to the project. We strongly value documentation and gladly accept improvements to the documentation. +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. ## Contributing code To submit a change for inclusion, please do the following: -#### If the change is non-trivial please include some unit tests that cover the new functionality. -#### If you are introducing a completely new feature or API it is a good idea to start a wiki and get consensus on the basic design first. -#### 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). +####If the change is non-trivial please include some unit tests that cover the new functionality. +####If you are introducing a completely new feature or API it is a good idea to start a wiki and get consensus on the basic design first. +####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). ## Becoming a Committer -We are always interested in adding new contributors. What we look for a series of contributions, good taste, and an ongoing interest in the project. If you are interested in becoming a committer, let one of the existing committers know and they can help guide you through the process. \ No newline at end of file +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 Console +#### RocketMQ SDK(C++\.Net\Php\Python\Go\Node.js) +#### RocketMQ MySQL(Oracle\PostgreSQL\Redis\MongoDB\HBase\MSSQL) Replicator + +##### 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 +###### Maintainability - Comply with our [checkstyle spec](checkstyle/checkstyle.xml),and at least 3 month update frequency +###### Deployability - We encourage you to deploy into [maven repository](http://search.maven.org/) http://git-wip-us.apache.org/repos/asf/incubator-rocketmq/blob/8d7dd2b3/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index 9c72002..20119d4 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -## RocketMQ -- Alibaba's MQ [](https://travis-ci.org/alibaba/RocketMQ) +## RocketMQ [](https://travis-ci.org/alibaba/RocketMQ) [](http://search.maven.org/#search%7Cga%7C1%7Ccom.alibaba.rocketmq) [](https://github.com/alibaba/RocketMQ/releases) [](https://www.apache.org/licenses/LICENSE-2.0.html) @@ -11,7 +11,7 @@ It offers a variety of features as follows: * Reliable FIFO and strict sequential messaging in the same queue * Long pull queue model,also support push consumption style * Million message accumulation ability in single queue -* Over a variety of messaging protocols.such as JMS,MQTT,HTTP etc. +* Over a variety of messaging protocols.such as JMS,MQTT etc. * Distributed high available deploy architecture, meets at least once message delivery semantics * Docker images for isolated testing and cloud Isolated clusters * Feature-rich administrative dashboard for configuration,metrics and monitoring [](https://www.aliyun.com/product/ons/?spm=5176.7960203.237031.135.67OdNO) @@ -22,30 +22,22 @@ It offers a variety of features as follows: ---------- ## Learn it & Contact us -* Homepage: <https://github.com/alibaba/RocketMQ> -* Mailing list: <https://groups.google.com/forum/?hl=en#!forum/rocketmq> -* Documentation: <https://github.com/alibaba/RocketMQ/wiki> -* Wiki: <https://github.com/alibaba/RocketMQ/wiki> -* Issues: <https://github.com/alibaba/RocketMQ/issues> +* Wiki: <https://cwiki.apache.org/confluence/display/ROCKETMQ/Apache+RocketMQ+Home> +* Issues: <https://issues.apache.org/jira/browse/RocketMQ> * Ask: <http://stackoverflow.com/questions/tagged/rocketmq> or <https://www.quora.com/topic/RocketMQ> * [](https://gitter.im/alibaba/RocketMQ?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) ---------- -## How can I develop with RocketMQ? -* [Download the latest release package](https://github.com/alibaba/RocketMQ/releases) -* [Get the latest document & Who using RocketMQ](https://github.com/alibaba/RocketMQ/issues/1) -* [`Using RocketMQ in Aliyun`](http://www.aliyun.com/product/ons) +## RocketMQ Community * [`Docker images`](https://registry.hub.docker.com/u/vongosling/rocketmq/) -* [Integrate with Alibaba JStorm](https://github.com/alibaba/jstorm) -* [Integrate with Alibaba Canal](https://github.com/alibaba/canal) * [RocketMQ Community Projects](https://github.com/rocketmq) ---------- ## Contributing -We are always very happy to have contributions, whether for trivial cleanups,big new features or other material rewards. more details see [here](https://github.com/alibaba/RocketMQ/wiki/How-to-donate) +We are always very happy to have contributions, whether for trivial cleanups,big new features or other material rewards. more details see [here](CONTRIBUTING.md) ---------- ## License
