There are many ways you can help make ActiveMQ a better piece of software - please dive in and help!

有很多方法可以让ActiveMQ成为更好的软件——请投入使用和帮助!

Try surf the documentation - if somethings confusing or not clear, let us know. Download the code & try it out and see what you think. Browse the source code. Got an itch to scratch, want to tune some operation or add some feature?

试着浏览一下文档——如果有些东西让人困惑或者不清楚,请告诉我们。下载代码并试一试,看看你的想法。浏览源代码。有痒到痒,想调一些操作或增加一些功能?

Want to do some hacking on ActiveMQ? Try surfing to our issue tracker for open issues or features that need to be implemented, take ownership of an issue and try fix it.

想对ActiveMQ进行一些黑客攻击吗?尝试浏览我们的问题跟踪器,了解需要实现的开放问题或特性,获取一个问题的所有权并尝试修复它。

Getting in touch

得到联系

There are various ways of communicating with the ActiveMQ community.

与ActiveMQ社区有多种沟通方式。

  • join us on the Discussion Forums or subscribe to the Mailing Lists and take part in any conversations
  • 加入我们的讨论论坛或订阅邮件列表并参与任何对话。
  • pop by on in irc and say hi

    在irc上突然出现,然后打个招呼。

  • add some comments to the wiki
  • 在wiki上添加一些注释。

If you find a bug or problem

如果你发现了一个错误或问题。

Please raise a new issue in our issue tracker

请在我们的问题追踪器中提出一个新问题。

If you can create a JUnit test case then your issue is more likely to be resolved quicker.
e.g. take a look at some of the existing unit tests cases

如果您可以创建一个JUnit测试用例,那么您的问题更有可能得到更快的解决。例如,看看一些现有的单元测试案例。

Then we can add your issue to the test suite and then we'll know when its really fixed and we can ensure that the problem stays fixed in future releases.

然后我们可以将您的问题添加到测试套件中,然后我们将知道它何时真正修复,并且我们可以确保问题在未来的版本中保持不变。

If you want to help out with the documentation

如果你想帮助文档。

If you want to contribute to the ActiveMQ documentation you should first subscribe our dev@ where ActiveMQ developers interact with each other. If you want edit rights on the ActiveMQ site, create an account in the ActiveMQ wiki and fill in and submit an ICLA to the ASF (see the Committer Guide). Then ask on the dev@ list to be granted edit rights and an admin will do so fairly quickly. If you want to just contribute the content, please submit the content on the dev@ list or create an issue and attach it there. All contributions are highly appreciated.

如果您想要为ActiveMQ文档做贡献,您应该首先订阅我们的dev@,在那里ActiveMQ开发人员相互交互。如果您想要在ActiveMQ站点上编辑权限,在ActiveMQ wiki中创建一个帐户,并填写并提交一个ICLA到ASF(见提交者指南)。然后,在dev@列表上请求被授予编辑权限,管理员将会很快完成。如果您只想贡献内容,请将内容提交到dev@列表或创建一个问题并将其附加到那里。所有的捐款都非常感谢。

Working on the code

在代码

Grab the Source from git

从git获取源代码。

Build the project.

构建项目。

export MAVEN_OPTS="-Xmx512M -XX:MaxPermSize=128M"
mvn -Dtest=false install

PS: You might need to build multiple times (if you get a build error) because sometimes maven fails to download all the files.

PS:您可能需要多次构建(如果您有一个构建错误),因为有时候maven无法下载所有的文件。

Create a project in your IDE. e.g. if you are using Eclipse the following should do the trick.

在IDE中创建一个项目。如果你用的是Eclipse,那么下面的方法就可以做到。

mvn eclipse:eclipse

Then import the projects into your workspace.

然后将项目导入到您的工作区中。

Creating patches

创建补丁

We gladly accept patches if you can find ways to improve, tune or fix ActiveMQ in some way.

我们很高兴地接受补丁,如果您能找到方法改进,调整或修复ActiveMQ在某些方面。

Most IDEs can create nice patches now very easily. e.g. in Eclipse just right click on a file/directory and select Team -> Create Patch. Then just save the patch as a file and then submit it. (You may have to click on Team -> Share... first to enable the Subversion options).

大多数ide现在可以很容易地创建漂亮的补丁。在Eclipse中右键单击文件/目录并选择Team ->创建补丁。然后将补丁保存为文件,然后提交。(你可能需要点击Team ->分享…首先启用Subversion选项)。

If you're a command line person try the following to create the patch

如果您是命令行人员,请尝试以下步骤创建补丁。

diff -u Main.java.orig Main.java >> patchfile.txt

or

git diff Main.java >> patchfile.txt

Submitting patches

提交补丁

The easiest way to submit a patch is to create a new JIRA issue, attach the patch and tick the ASF license grant check box, tick the Patch Attached button on the issue then fire off an email to the Mailing Lists or Discussion Forums.

提交补丁的最简单方法是创建一个新的JIRA发行版,附加补丁并在ASF许可证授予复选框中勾选,然后在该问题上附加一个补丁,然后将邮件发送到邮件列表或讨论论坛。

Becoming a commmitter

成为一个commmitter

Once you've got involved as above, we may well invite you to be a committer. See Becoming a committer for more details.

一旦你参与其中,我们很可能会邀请你成为一名委员。更多细节请参见提交人。

Using the issue tracker

使用问题跟踪器

Before you can raise an issue in the issue tracker you need to register with it. This is quick & painless.

在你在问题追踪器中提出一个问题之前,你需要注册它。这是快速和无痛的。

If you want to have a go at fixing an issue you need to be in the list of activemq-developers on the issue tracker. To join the group, please mail the dev@activemq.apache.org mail list with the email address you used to register with the issue tracker and we'll add you to the group.

如果您想要解决一个问题,您需要在问题跟踪器上的activemq-开发者列表中。要加入这个群组,请将你以前注册过的邮箱地址:dev@activemq.apache.org邮件列表,并将你添加到群组中。

Why not dive in the issue tracker, and try tackle some of our outstanding issues?

为什么不在问题追踪系统中潜水,试着解决一些悬而未决的问题呢?

Becoming a committer

成为一个提交者

The first step is contributing to the project; if you want to take that a step forward and become a fellow committer on the project then see the Committer Guide

第一步是对项目做出贡献;如果你想要向前迈出一步,并成为项目的一个成员,那么请参见提交人指南。

© 2004-2011 The Apache Software Foundation.
Apache ActiveMQ, ActiveMQ, Apache, the Apache feather logo, and the Apache ActiveMQ project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
Graphic Design By Hiram