| <div class="wiki-content maincontent"><p>There are many ways you can help make ActiveMQ a better piece of software - please dive in and help!</p><p>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?</p><p>Want to do some hacking on ActiveMQ? Try surfing to our <a shape="rect" href="http://issues.apache.org/jira/browse/AMQ">issue tracker</a> for open issues or features that need to be implemented, take ownership of an issue and try fix it.</p><h2>Getting in touch</h2><p>There are various ways of communicating with the ActiveMQ community.</p><ul class="alternate"><li>join us on the <link><page ri:content-title="Discussion Forums"></page></link> or subscribe to the <link><page ri:content-title="Mailing Lists"></page></link> and take part in any conversations</li><li><p>pop by on <span>in <link><page ri:content-title="IRC"></page><plain-text-link-body>irc</plain-text-link-body></link> and say hi</span></p></li><li>add some comments to the <link><page ri:content-title="Navigation"></page><plain-text-link-body>wiki</plain-text-link-body></link></li></ul><h2>If you find a bug or problem</h2><p>Please raise a new issue in our <a shape="rect" href="https://issues.apache.org/jira/browse/AMQ">issue tracker</a></p><p>If you can create a JUnit test case then your issue is more likely to be resolved quicker.<br clear="none"> e.g. take a look at some of the existing <a shape="rect" href="https://git-wip-us.apache.org/repos/asf?p=activemq.git;a=tree;f=activemq-unit-tests/src/test;h=185a655c5200ed30fd2964bc236c18c5bde534c4;hb=refs/heads/master">unit tests cases</a></p><p>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 <strong>stays fixed</strong> in future releases.</p><h2>If you want to help out with the documentation</h2><p>If you want to contribute to the ActiveMQ documentation you should first subscribe our <a shape="rect" href="mailto:dev-subscribe@activemq.apache.org">dev@</a> where ActiveMQ developers interact with each other. If you want edit rights on the ActiveMQ site, create an account in the <a shape="rect" href="https://cwiki.apache.org/confluence/display/ACTIVEMQ">ActiveMQ wiki</a> and fill in and submit an ICLA to the ASF (see the <link><page ri:content-title="Becoming a committer"></page><plain-text-link-body>Committer Guide</plain-text-link-body></link>). 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. <strong>All</strong> contributions are highly appreciated.</p><h2>Working on the code</h2><p>Grab the <link><page ri:content-title="Source"></page></link> from git</p><p>Build the project.</p><structured-macro ac:macro-id="25d641b3-f919-4efd-a2ce-8623d0c25cc4" ac:name="code" ac:schema-version="1"><plain-text-body>export MAVEN_OPTS="-Xmx512M -XX:MaxPermSize=128M" |
| mvn -Dtest=false install |
| </plain-text-body></structured-macro><p>PS: You might need to build multiple times (if you get a build error) because sometimes maven fails to download all the files.</p><p>Create a project in your IDE. e.g. if you are using Eclipse the following should do the trick.</p><structured-macro ac:macro-id="e56c51bd-0335-411a-af24-ad8f058f506e" ac:name="code" ac:schema-version="1"><plain-text-body>mvn eclipse:eclipse |
| </plain-text-body></structured-macro><p>Then import the projects into your workspace.</p><h2>Creating patches</h2><p>We gladly accept patches if you can find ways to improve, tune or fix ActiveMQ in some way.</p><p>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).</p><p>If you're a command line person try the following to create the patch</p><structured-macro ac:macro-id="2d0a96df-60e0-465e-9fd4-f4ad65c58016" ac:name="code" ac:schema-version="1"><plain-text-body>diff -u Main.java.orig Main.java >> patchfile.txt |
| </plain-text-body></structured-macro><p>or</p><structured-macro ac:macro-id="c70274da-13ad-4f5e-9cd5-b777ce4af0d0" ac:name="code" ac:schema-version="1"><plain-text-body>git diff Main.java >> patchfile.txt |
| </plain-text-body></structured-macro><h2>Submitting patches</h2><p>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 <link><page ri:content-title="Mailing Lists"></page></link> or <link><page ri:content-title="Discussion Forums"></page></link>.</p><h2>Becoming a commmitter</h2><p>Once you've got involved as above, we may well invite you to be a committer. See <link><page ri:content-title="Becoming a committer"></page></link> for more details.</p><h2>Using the issue tracker</h2><p>Before you can raise an issue in the issue tracker you need to register with it. This is quick & painless.</p><p>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 <a shape="rect" href="mailto:dev@activemq.apache.org">dev@activemq.apache.org</a> mail list with the email address you used to register with the issue tracker and we'll add you to the group.</p><p>Why not dive in the <a shape="rect" href="https://issues.apache.org/jira/browse/AMQ">issue tracker</a>, and try tackle some of our outstanding issues?</p><h2>Becoming a committer</h2><p>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 <link><page ri:content-title="Becoming a committer"></page><plain-text-link-body>Committer Guide</plain-text-link-body></link></p></div> |
| |
