| I"Ú<h2 id="contribute">Ways to Contribute to Apache Wicket</h2> |
| |
| <p>A lot of work goes into maintaining a project like Wicket and we can |
| use your help!</p> |
| |
| <p>You can help us in many ways:</p> |
| |
| <ul> |
| <li>Help out other users at our <a href="../help/email.html">user list</a></li> |
| <li>Answer questions on <a href="http://stackoverflow.com/questions/tagged/wicket" rel="nofollow">Stackoverflow</a></li> |
| <li><a href="userguide.html">Improve our user guide</a></li> |
| <li>Report <a href="../help/#reportbug">your bugs</a></li> |
| <li>Implement <a href="patch.html">new features or fix bugs</a></li> |
| <li><a href="write.html">Improve this site</a></li> |
| </ul> |
| |
| <p>If you want to help out with one of our bugs or want to implement a |
| feature, consider using our <a href="#github">Github mirror</a>.</p> |
| |
| <hr /> |
| |
| <h2 id="github">Github Mirror for Easy Contributing</h2> |
| |
| <p>Wicket is mirrored on github so you can contribute with ease:</p> |
| |
| <ol> |
| <li>Fork Wicket</li> |
| <li>Implement your feature or fix the bug, and</li> |
| <li>Send a pull request.</li> |
| </ol> |
| |
| <p>The Github/Apache integration will send the pull request to our |
| contributors list, and we will look at your pull request as soon as we |
| can.</p> |
| |
| <h3 id="fork">Fork Wicket to your Account</h3> |
| |
| <p>So you have an account registered at Github and are ready to start |
| hacking at Wicket. First you need to <em>fork the code</em> to your own Github |
| account.</p> |
| |
| <p>You can find the official mirror for the Apache Wicket project at the |
| following location in the official Apache Software Foundation |
| organisation at Github:</p> |
| |
| <ul> |
| <li>Apache Wicket Github mirror: <a href="https://github.com/apache/wicket" rel="nofollow">https://github.com/apache/wicket</a></li> |
| </ul> |
| |
| <p>On this page you will find a button with the caption âForkâ. Click it |
| or use the button below.</p> |
| |
| <p><a class="button" rel="nofollow" href="https://github.com/apache/wicket/fork"> |
| <i class="fa fa-github"></i> Fork us on github |
| </a></p> |
| |
| <p>Now you have your own copy of Wicket to hack on. You can edit directly |
| in the Github web interfaceâgood for minor fixes like documentation |
| errorsâor clone the project to your workstation.</p> |
| |
| <h3 id="clone">Clone Wicket to your Workstation</h3> |
| |
| <p>You can use the tooling for Github to get a copy on your workstation or |
| use the commandline:</p> |
| |
| <figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="nv">$ </span>git clone git@github.com:<your userid>/wicket.git</code></pre></figure> |
| |
| <p><strong>NB</strong> Ensure that you replace <em><your userid></em> with your actual |
| Github user id, otherwise your clone command will fail.</p> |
| |
| <p>This shell command will create a local checkout of the git repository. |
| Now you can check out the correct branch.</p> |
| |
| <h3 id="checkout">Start with the Correct Branch</h3> |
| |
| <p>Wicket is developed in several version branches. Depending on what you |
| want to work on you need to select the right one. The following table |
| shows the corresponding branch for each Wicket version.</p> |
| |
| <table> |
| <thead> |
| <tr> |
| <th>Wicket version</th> |
| <th>Branch name</th> |
| <th>Status</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td>8.x</td> |
| <td>master</td> |
| <td>active</td> |
| </tr> |
| <tr> |
| <td>7.x</td> |
| <td>wicket-7.x</td> |
| <td>supported</td> |
| </tr> |
| <tr> |
| <td>6.x</td> |
| <td>wicket-6.x</td> |
| <td>supported</td> |
| </tr> |
| <tr> |
| <td>1.5.x</td> |
| <td>wicket-1.5.x</td> |
| <td>security fixes only</td> |
| </tr> |
| <tr> |
| <td><s>1.4.x</s></td> |
| <td><s>wicket-1.4.x</s></td> |
| <td><s>discontinued</s></td> |
| </tr> |
| <tr> |
| <td><s>1.3.x</s></td> |
| <td><s>wicket-1.3.x</s></td> |
| <td><s>discontinued</s></td> |
| </tr> |
| <tr> |
| <td><s>1.2.x</s></td> |
| <td><s>wicket-1.2.x</s></td> |
| <td><s>discontinued</s></td> |
| </tr> |
| <tr> |
| <td><s>1.1.x</s></td> |
| <td><s>wicket-1.1.x</s></td> |
| <td><s>discontinued</s></td> |
| </tr> |
| <tr> |
| <td><s>1.0.x</s></td> |
| <td><s>wicket-1.0.x</s></td> |
| <td><s>discontinued</s></td> |
| </tr> |
| </tbody> |
| </table> |
| |
| <p>If you want to work on Wicket 8, you need to check out the <em>master</em> branch.</p> |
| |
| <p>If you want to work on Wicket 7, you need to check out the <em>wicket-7.x</em> branch.</p> |
| |
| <p>If you want to work on an issue for Wicket 6, youâll need to check out the <em>wicket-6.x</em> branch.</p> |
| |
| <p>When you are ready with your change you can ask us to review your |
| changes and to integrate it into Wicket by creating a Pull Request.</p> |
| |
| <h3 id="pullrequest">Create a Pull Request</h3> |
| |
| <p>Make sure you have pushed your changes to your Github repository. To |
| create a pull request on GitHub follow the instructions you can find <a href="https://help.github.com/articles/creating-a-pull-request/" rel="nofollow">here</a>. Once you have finished to work on you pull |
| request, send us an email using <a href="mailto:dev@wicket.apache.org">devs</a> |
| mailing list.</p> |
| |
| <p>The GithubâApache integration will automatically send a message to the |
| Wicket project that a new pull request is waiting for us.</p> |
| |
| <h2 id="documentation">Documentation for contributors</h2> |
| |
| <p>This section is particularly of interest for those who want to |
| contribute to Wicket.</p> |
| |
| <h3 id="how-to-contribute">How to contribute</h3> |
| |
| <p>Hereâs a list of documents that explain how you can best help the Wicket team:</p> |
| |
| <ul> |
| <li><a href="/contribute/userguide.html">Write documentation</a> - Contribute to improve our user guide.</li> |
| <li><a href="/contribute/patch.html">Provide a patch or a pull request</a> - Think you have found a bug or just want to propose a new feature? Do it sending us a patch or creating a pull request on GitHub.</li> |
| <li><a href="/contribute/write.html">Contribute to the site</a> - Help us to improve our site.</li> |
| </ul> |
| |
| <h3 id="committers">Committers</h3> |
| |
| <p>Hereâs a list of tasks that only committers can do:</p> |
| |
| <ul> |
| <li><a href="/contribute/release.html">Build a release</a></li> |
| </ul> |
| |
| <h3 id="subscribing-and-unsubscribing">Subscribing and unsubscribing</h3> |
| |
| <p><a href="mailto:dev@wicket.apache.org">Wicket development list</a> |
| Medium traffic |
| <a href="http://mail-archives.apache.org/mod_mbox/wicket-dev/">Archives</a> |
| <a href="http://wicket-dev.markmail.org/">Search</a> |
| <a href="mailto:dev-subscribe@wicket.apache.org?subject=Subscribe to Apache Wicket development list">Subscribe</a> |
| <a href="mailto:dev-unsubscribe@wicket.apache.org?subject=Unsubscribe from Apache Wicket development list">Unsubscribe</a> |
| <a href="mailto:dev-help@wicket.apache.org?subject=Help for Apache Wicket development list">Help</a></p> |
| |
| :ET |