Modified: karaf/site/production/cave_installation.html URL: http://svn.apache.org/viewvc/karaf/site/production/cave_installation.html?rev=1817099&r1=1817098&r2=1817099&view=diff ============================================================================== --- karaf/site/production/cave_installation.html (original) +++ karaf/site/production/cave_installation.html Mon Dec 4 15:57:03 2017 @@ -18,36 +18,84 @@ </head> <body> <div class="viewport"> - - <h2>Apache Karaf Cave Installation</h2> - - Apache Karaf Cave is a complete artifacts repository (OSGi Repository, OBR, Maven) solution for Apache Karaf Container. - <br/> - Cave can be directly installed on running Karaf Container instances. Take a look on the <a href="documentation.html">Karaf Cave documentation</a> for details. - - <h3>On Karaf Cave 4.x (Cave 4.x)</h3> - <div class="code"> - <pre> - feature:repo-add cave - feature:install cave - </pre> + <header class="navbar header--navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <div class="karaf-logo--container"> + <a class="karaf-logo" href="index.html"><span></span></a> + </div> + <ul class="nav pull-right"> + <li class="navbar-link"> + <a href="download.html">Download</a> + </li> + <li class="navbar-link"> + <a href="documentation.html">Documentation</a> + </li> + <li class="navbar-link"> + <a href="projects.html">Projects</a> + </li> + <li class="navbar-link"> + <a href="community.html">Community</a> + </li> + <li class="navbar-link"> + <a href="http://www.apache.org";><img src="images/apache-feather-tm.svg"/></a> + </li> + </ul> + </div> + </div> + </header> + + <div class="container"> + <div id="content"> + <div class="content--panel"> + <h2>Apache Karaf Cave Installation</h2> + + Apache Karaf Cave is a complete artifacts repository (OSGi Repository, OBR, Maven) solution for Apache Karaf Container. + <br/> + Cave can be directly installed on running Karaf Container instances. Take a look on the <a href="documentation.html">Karaf Cave documentation</a> for details. + <br/><br/> + <h3>On Karaf Cave 4.x (Cave 4.x)</h3> + <div class="code"> + <pre> + feature:repo-add cave + feature:install cave + </pre> + </div> + + <h3>On Karaf Cave 3.x (Cave 3.x)</h3> + <div class="code"> + <pre> + feature:repo-add cave 3.x + feature:install cave + </pre> + </div> + + <h3>On Karaf Container 2.x (Cave 2.x)</h3> + <div class="code"> + <pre> + features:chooseUrl cave 2.x + features:install cave + </pre> + </div> + </div> + </div> </div> - <h3>On Karaf Cave 3.x (Cave 3.x)</h3> - <div class="code"> - <pre> - feature:repo-add cave 3.x - feature:install cave - </pre> - </div> - - <h3>On Karaf Container 2.x (Cave 2.x)</h3> - <div class="code"> - <pre> - features:chooseUrl cave 2.x - features:install cave - </pre> - </div> + <div class="body--container container-fluid "></div> + <footer class="footer"> + <div class="container-fluid"> + <div class="row-fluid"> + <div class="span12"> + <div class="footer-documentation--text"> + © <span>2017</span> <a href="http://www.apache.org";>Apache Software Foundation</a> - <a + href="privacy.html">Privacy Policy</a><br/> + Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are + trademarks of The Apache Software Foundation.</div> + </div> + </div> + </div> + </footer> + <div id="scrim"></div> </div> </body>
Modified: karaf/site/production/cellar_installation.html URL: http://svn.apache.org/viewvc/karaf/site/production/cellar_installation.html?rev=1817099&r1=1817098&r2=1817099&view=diff ============================================================================== --- karaf/site/production/cellar_installation.html (original) +++ karaf/site/production/cellar_installation.html Mon Dec 4 15:57:03 2017 @@ -18,37 +18,85 @@ </head> <body> <div class="viewport"> - - <h2>Apache Karaf Cellar Installation</h2> - - Apache Karaf Cellar is a complete clustering solution for Apache Karaf Container. - <br/> - Cellar can be directly installed on running Karaf Container instances. Take a look on the <a href="documentation.html">Karaf Cellar documentation</a> for details. - - <h3>On Karaf Container 4.x (Cellar 4.x)</h3> - <div class="code"> - <pre> - feature:repo-add cellar - feature:install cellar - </pre> - </div> - - <h3>On Karaf Container 3.x (Cellar 3.x)</h3> - <div class="code"> - <pre> - feature:repo-add cellar 3.x - feature:install cellar - </pre> - </div> - - <h3>On Karaf Container 2.x (Cellar 2.x)</h3> - <div class="code"> - <pre> - features:chooseUrl cellar 2.x - features:install cellar - </pre> + <header class="navbar header--navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <div class="karaf-logo--container"> + <a class="karaf-logo" href="index.html"><span></span></a> + </div> + <ul class="nav pull-right"> + <li class="navbar-link"> + <a href="download.html">Download</a> + </li> + <li class="navbar-link"> + <a href="documentation.html">Documentation</a> + </li> + <li class="navbar-link"> + <a href="projects.html">Projects</a> + </li> + <li class="navbar-link"> + <a href="community.html">Community</a> + </li> + <li class="navbar-link"> + <a href="http://www.apache.org";><img src="images/apache-feather-tm.svg"/></a> + </li> + </ul> + </div> + </div> + </header> + + <div class="container"> + <div id="content"> + <div class="content--panel"> + + <h2>Apache Karaf Cellar Installation</h2> + + Apache Karaf Cellar is a complete clustering solution for Apache Karaf Container. + <br/> + Cellar can be directly installed on running Karaf Container instances. Take a look on the <a href="documentation.html">Karaf Cellar documentation</a> for details.<br/><br/> + + <h3>On Karaf Container 4.x (Cellar 4.x)</h3> + <div class="code"> + <pre> + feature:repo-add cellar + feature:install cellar + </pre> + </div> + + <h3>On Karaf Container 3.x (Cellar 3.x)</h3> + <div class="code"> + <pre> + feature:repo-add cellar 3.x + feature:install cellar + </pre> + </div> + + <h3>On Karaf Container 2.x (Cellar 2.x)</h3> + <div class="code"> + <pre> + features:chooseUrl cellar 2.x + features:install cellar + </pre> + </div> + </div> + </div> </div> + <div class="body--container container-fluid "></div> + <footer class="footer"> + <div class="container-fluid"> + <div class="row-fluid"> + <div class="span12"> + <div class="footer-documentation--text"> + © <span>2017</span> <a href="http://www.apache.org";>Apache Software Foundation</a> - <a + href="privacy.html">Privacy Policy</a><br/> + Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are + trademarks of The Apache Software Foundation.</div> + </div> + </div> + </div> + </footer> + <div id="scrim"></div> </div> </body> </html> \ No newline at end of file Modified: karaf/site/production/community.html URL: http://svn.apache.org/viewvc/karaf/site/production/community.html?rev=1817099&r1=1817098&r2=1817099&view=diff ============================================================================== --- karaf/site/production/community.html (original) +++ karaf/site/production/community.html Mon Dec 4 15:57:03 2017 @@ -44,7 +44,7 @@ </div> </div> </header> -<br/> + <div class="container"> <div id="menu" class="desktop-only"> <h1>Community</h1> @@ -60,328 +60,339 @@ <li><a href="#team">Team</a></li> </ul> </div> + <div id="content"> - <h2 id="resources">Resources</h2> - <h3 id="mailinglists">Mailing Lists</h3> - <ul class="community"> - <li>Users List [ <a href="mailto:[email protected]";>subscribe</a> | <a href="http://mail-archives.apache.org/mod_mbox/karaf-user/";>archives</a> | <a href="http://karaf.922171.n3.nabble.com/Karaf-User-f930749.html";>online forum</a> ]</li> - <li>Developers List [ <a href="mailto:[email protected]";>subscribe</a> | <a href="http://mail-archives.apache.org/mod_mbox/karaf-dev/";>archives</a> | <a href="http://karaf.922171.n3.nabble.com/Karaf-Dev-f930721.html";>online forum</a> ]</li> - <li>Commits List [ <a href="mailto:[email protected]";>subscribe</a> | <a href="http://mail-archives.apache.org/mod_mbox/karaf-commits/";>archives</a> ]</li> - <li>Issues List [ <a href="mailto:[email protected]";>subscribe</a> | <a href="http://mail-archives.apache.org/mod_mbox/karaf-issues/";>archives</a> ]</li> - </ul> - <h3 id="bugtracker">Bug Tracker, IRC, and CI</h3> - <ul class="community"> - <li><a href="https://issues.apache.org/jira/browse/KARAF";>Jira</a></li> - <li><a href="https://builds.apache.org/view/H-L/view/Karaf/";>Jenkins</a></li> - <li><a href="irc://irc.freenode.net/apache-karaf">#apache-karaf on Freenode</a></li> - </ul> - - <h2 id="contribute">Contribute</h2> - There are many ways you can help make Karaf a better piece of software - please dive in and help!<br/> - <br/> - Try browsing the <a href="documentation.html">documentation</a> - if something's confusing or not clear, let us know.<br/> - <br/> - <a href="download.html">Download</a> the code & try it out and see what you think.<br/> - <br/> - <a href="https://github.com/apache/karaf";>Browse the source code</a>. Got an itch to scratch, want to tune some operation or add some feature ?<br/> - <br/> - If you'd rather have a more gentle introduction to working on the Karaf project, try looking at the test coverage report and help us get it even more green by supplying more test cases to get us closer to 100% coverage. - - <h3 id="issue">Report bugs and feature requests</h3> - - <p>Did you find a bug or want something implemented? Please report an issue in our <a href="https://issues.apache.org/jira/browse/KARAF";>issue tracker</a>. When creating a bug make sure you document the steps to reproduce the issue and provide all necessary information like OS, versions your use, logs. When creating a feature request document your requirements first. Try to not directly describe the solution.<p> - - <p>If you want to dive into development yourself then you can also browse for open issues or features that need to be implemented. Take ownership of an issue and try fix it. Before doing a bigger change describe the concept/design of what you plan to do. If unsure if the design is good or will be accepted discuss it on the dev list.</p> - - <h3 id="pull-request">Provide changes in a pull request</h3> - - The best way to provide changes is to fork karaf repo on github and provide a pull request with your changes. To make it easy to apply your changes please use the following conventions: - <ul class="community"> - <li>Every pull request should have a matching jira issue</li> - <li>Do the change in a branch that is named like the jira issue id e.g KARAF-1234. To create this branch you can use:<br/> - <code> -git clone http://github.com/apache/karaf<br/> -git fetch --all<br/> -git checkout -b my-branch origin/master<br/> - </code> - Don't forget to periodically rebase your branch:<br/> - <code> -git pull --rebase<br/> -git push GitHubUser my-branch --force<br/> - </code> - </li> - <li>Every commit in the branch should start with the jira issue id like this "[KARAF-123] More details"</li> - <li>You can squash your commits into one and force push your branch (not mandatory) using <code>git rebase -i apache/master</code></li> - <li>Test that your change works by adapting or adding tests.</li> - <li><a href="http://programmer.97things.oreilly.com/wiki/index.php/The_Boy_Scout_Rule";>Follow the boy scout rule to "Always leave the campground cleaner than you found it."</a></li> - <li>Make sure you do a build before doing a PR. The build has to be successfull:<br/> - <code> -mvn clean verify -Prelease -fae -T 1C - </code> - </li> - <li>If your PR has conflicts with the master then rebase the branch. PRs with conflicts are unlikely to be applied</li> - <li>Do not change too much in a PR. The smaller the PR the easier it is to apply and the faster it will be done</li> - <li>Sometimes PRs get lost. Do not hesitate to ask on the dev list if your PR seems to be ignored</li> - </ul> - - <h3 id="review-pull-request">Review pull requests</h3> - - Anyone can review pull requests but the merge can be done only by a committer.<br/> - If you want to review a PR then comment with <code>R:@yourgithubid</code>. This marks that you will do the review and also apply if you are a committer.<br/> - When reviewing check if the changes are done in a clean way and are tested with a unit and possibly integration test. Check that the build does not report more test failures than before. If you are not a committer then write a comment if you recommend a merge or not. Provide good instructions for the contributor how to improve his PR if it is not yet ok. Make sure you do a review timely. By commenting that you do a review you kind of block others from applying the change.<br/> - NB: Jenkins performs a build for each pull request. You can trigger a new build on a pull request using "retest this please" in a PR comment. - - <h3 ir="apply-pull-request">Apply pull requests</h3> - - This can obviously only be done by a committer. Do the following steps: - - <ul class="community"> - <li> - <li>As one time config, you can rename your git remote and add apache one: - <code> -git remote add apache https://gitbox.apache.org/repos/asf/karaf.git<br/> - </code> - We recommand renaming <code>origin</code> as <code>github</code>:<br/> -<code> -git remote rename origin github<br/> -</code> - For <code>github</code> remote, add an additional fetch reference, which will cause every pull request to be made available as a remote branch in your workspace.<br/> -<code> -git config --local --add remote.github.fetch '+refs/pull/*/head:refs/remotes/github/pr/*' -</code> - You can confirm your configuration with the following command: -<code> -git remote -v<br/> -apache https://gitbox.apache.org/repos/asf/karaf.git (fetch)<br/> -apache https://gitbox.apache.org/repos/asf/karaf.git (push)<br/> -github https://github.com/apache/karaf.git (fetch)<br/> -github https://github.com/apache/karaf.git (push)<br/> -username [email protected]:username/karaf.git (fetch)<br/> -username [email protected]:username/karaf.git (push)<br/> -</code> - </li> - <li>Checkout the PR:<br/> -<code> -git fetch --all -git checkout -b pr-xxx github/pr/xxx -</code> - </li> - <li> - Review the PR, amend, squash the commits, requesting changes, ... When done, add <code>LGTM</code> comment to approve the PR (or click on the "Approve" button on GitHub):<br/> -<code> -git rebase -i apache/master -</code> - </li> - <li> - Merge the PR (it automatically closes the PR):<br/> -<code> -git fetch --all<br/> -git checkout apache/master<br/> -git merge --no-ff -m "[KARAF-nnnn] This closes #xxx" pr-xxx -git push apache HEAD:master -</code> - </li> - <li>Eventually backport commits to bugfix branches using <code>git cherry-pick</code></li> - <li>Make sure you document the fix in jira by adding the fix versions and resolve the jira issue</li> - <li>You can delete the PR branch: <code>git branch -D pr-xxx</code>.</li> - </ul> - - <h3 id="improve karaf website">Improve the karaf website</h3> - - The content of the website http://karaf.apache.org is stored in the svn repo <a href="https://svn.apache.org/repos/asf/karaf/site/trunk";>karaf site</a>. See the <a href="https://svn.apache.org/repos/asf/karaf/site/trunk/README.md";>README.md</a> on top level for how to test and publish the website. - - <h2 id="support">Support</h2> - If you are experiencing problems using Karaf then please report your problem to our <a href="https://issues.apache.org/jira/browse/KARAF";>issue tracker</a>. - You may also find it useful to discuss your issues with the community on the mailing lists or IRC.<br/> - <h3>How to get help</h3> - Whenever you are reporting a problem please be sure to include as much information as possible; the more we know the more chance of a quicker resolution. - <ul class="community"> - <li>which Karaf version you're using</li> - <li>what platform and JDK?</li> - <li>the particular OSGi container being used - if so what version</li> - <li>stack traces generally really help! If in doubt include the whole thing; often exceptions get wrapped in other exceptions and the exception right near the bottom explains the actual error, not the first few lines at the top. It's very easy for us to skim-read past unnecessary parts of a stack trace</li> - <li>log output can be useful too; sometimes enabling DEBUG logging can help</li> - <li>your code & configuration files are often useful. Be careful not to send us anything of a sensitive nature</li> - <li>did it work before, what have you changed to break it?</li> - <li>try upgrading to the latest release and see if it's fixed in that release</li> - <li>try the latest SNAPSHOT to see if it's fixed in that release</li> - <li>search the user mailing list to see if has been discussed before</li> - <li>check the issue tracker to see if the issue already have been reported</li> - </ul> - <h3>How to get help faster</h3> - We may be able to help you much more quickly if you try the following - <ul class="community"> - <li>provide us with a JUnit test case that demonstrates your issue. e.g. if you think you've found a bug, can you create a test case to demonstrate the bug ?</li> - <li>submit a patch fixing the bug! (we also buy you beer when we meet you if you submit bug fixes :) )</li> - <li>for memory leak or performance related issues, if you can run a profiler on your test case and attach the output as a file (or zipped file if it's huge) to the JIRA we can normally fix things much quickly. E.g. you could run jmap/jhat, JProfiler or YourKit on your code and send us the output. To find memory leaks it's quicker to resolve if you can tell us what classes are taking up all of the RAM; we can normally figure out what's wrong from that</li> - </ul> - <h3>Commercial Support</h3> - Apache Karaf is a widely used project. As such, several companies have built products and services around Karaf. - Companies are definitely encouraged to update this page directly or send a mail to the Karaf PMC with a description of your offerings and we can update the page. The products and services listed on this page are provided for information use only to our users. The Karaf PMC does not endorse or recommend any of the products or services on this page. - <ul class="community"> - <li><a href="https://www.codecentric.de/";>Codecentric</a> provides consulting and training for Apache Karaf and related technologies e.g. Apache Camel, Apache ActiveMQ and CXF for the DACH region.</li> - <li><a href="http://www.savoirtech.com/";>Savior Technologies, Inc</a> contributes and commits to the Apache Karaf project, while providing enterprise consulting, training and support for Karaf and a host of other Apache service containers. Savoir can provide best practice mentoring for developing with Karaf, as well as architectural/design reviews, troubleshooting and SOA infrastructure implementations.</li> - <li><a href="http://www.talend.com/";>Talend</a> uses and contributes on Apache Karaf. The Talend Runtime is based on Karaf. Talend has a dedicated team for the Apache projects. This team provides consulting, training, specific development, and support on Karaf (and other Apache projects).</li> - </ul> - <h2 id="team">Team</h2> - <table border="1" width="90%"> - <thead> - <td><b>Name</b></td> - <td><b>ID</b></td> - <td><b>PMC</b></td> - <td><b>Organisation</b></td> - </thead> - <tbody> - <tr> - <td>David Bosschaert</td> - <td>davidb</td> - <td></td> - <td></td> - </tr> - <tr> - <td><a href="http://iocanel.blogspot.com/";>Ioannis Canellos</a></td> - <td>iocanel</td> - <td><img src="images/check.gif"/></td> - <td><a href="http://www.jboss.org/";>JBoss</a></td> - </tr> - <tr> - <td>Hiram Chirino</td> - <td>chirino</td> - <td></td> - <td><a href="http://www.jboss.org/";>JBoss</a></td> - </tr> - <tr> - <td>Chris Custine</td> - <td>ccustine</td> - <td><img src="images/check.gif"/></td> - <td></td> - </tr> - <tr> - <td>Andrea Cosentino</td> - <td>acosentino</td> - <td></td> - <td><a href="http://www.redhat.com/";>RedHat</a></td> - </tr> - <tr> - <td><a href="http://blog.code-house.org/";>Lukasz Dywicki</a></td> - <td></td> - <td></td> - <td></td> - </tr> - <tr> - <td><a href="http://freemanfang.blogspot.com/";>Freeman Fang</a></td> - <td>ffang</td> - <td><img src="images/check.gif"/></td> - <td><a href="http://www.jboss.org/";>JBoss</a></td> - </tr> - <tr> - <td>Jarek Gawor</td> - <td>jgawor</td> - <td><img src="images/check.gif"/></td> - <td><a href="http://www.ibm.com";>IBM</a></td> - </tr> - <tr> - <td>Christoph Gritschenberger</td> - <td>christophg</td> - <td></td> - <td></td> - </tr> - <tr> - <td><a href="http://icodebythesea.blogspot.com/";>Jamie Goodyear</a></td> - <td>jgoodyear</td> - <td><img src="images/check.gif"/></td> - <td><a href="http://www.savoirtech.com/";>Savoir Technologies</a></td> - </tr> - <tr> - <td>David Jencks</td> - <td>djencks</td> - <td><img src="images/check.gif"/></td> - <td><a href="http://www.ibm.com";>IBM</a></td> - </tr> - <tr> - <td>Alex Karasulu</td> - <td>akarasulu</td> - <td><img src="images/check.gif"/></td> - <td></td> - </tr> - <tr> - <td><a href="http://cmoulliard.blogspot.com/";>Charles Moulliard</a></td> - <td>cmoulliard</td> - <td><img src="images/check.gif"/></td> - <td><a href="http://www.jboss.org/";>JBoss</a></td> - </tr> - <tr> - <td><a href="http://notizblog.nierbeck.de/";>Achim Nierbeck</a></td> - <td>anierbeck</td> - <td><img src="images/check.gif"/></td> - <td><a href="http://codecentric.de/";>Codecentric</a></td> - </tr> - <tr> - <td><a href="http://gnodet.blogspot.com/";>Guillaume Nodet</a></td> - <td>gnodet</td> - <td><img src="images/check.gif"/></td> - <td><a href="http://www.jboss.org/";>JBoss</a></td> - </tr> - <tr> - <td><a href="http://blog.nanthrax.net";>Jean-Baptiste Onofre</a></td> - <td>jbonofre</td> - <td><img src="images/check.gif"/></td> - <td><a href="http://www.talend.com";>Talend</a></td> - </tr> - <tr> - <td>Andreas Pieber</td> - <td>pieber</td> - <td><img src="images/check.gif"/></td> - <td></td> - </tr> - <tr> - <td>James Strachan</td> - <td>jstrachan</td> - <td></td> - <td><a href="http://www.jboss.org/";>JBoss</a></td> - </tr> - <tr> - <td>Christian Schneider</td> - <td>cschneider</td> - <td></td> - <td><a href="http://www.talend.com";>Talend</a></td> - </tr> - <tr> - <td>Adrian Trenaman</td> - <td></td> - <td></td> - <td></td> - </tr> - <tr> - <td>Gert Vanthienen</td> - <td>gertv</td> - <td><img src="images/check.gif"/></td> - <td><a href="http://www.jboss.org/";>JBoss</a></td> - </tr> - <tr> - <td>Brian Topping</td> - <td>btopping</td> - <td></td> - <td></td> - </tr> - <tr> - <td>Heath Kesler</td> - <td>hkesler</td> - <td></td> - <td><a href="http://www.savoirtech.com/";>Savoir Technologies</a></td> - </tr> - </tbody> - </table> - <br/><br/> + <div class="content--panel"> + <h2 id="resources">Resources</h2> + <h3 id="mailinglists">Mailing Lists</h3> + <ul class="community"> + <li>Users List [ <a href="mailto:[email protected]";>subscribe</a> | <a href="http://mail-archives.apache.org/mod_mbox/karaf-user/";>archives</a> | <a href="http://karaf.922171.n3.nabble.com/Karaf-User-f930749.html";>online forum</a> ]</li> + <li>Developers List [ <a href="mailto:[email protected]";>subscribe</a> | <a href="http://mail-archives.apache.org/mod_mbox/karaf-dev/";>archives</a> | <a href="http://karaf.922171.n3.nabble.com/Karaf-Dev-f930721.html";>online forum</a> ]</li> + <li>Commits List [ <a href="mailto:[email protected]";>subscribe</a> | <a href="http://mail-archives.apache.org/mod_mbox/karaf-commits/";>archives</a> ]</li> + <li>Issues List [ <a href="mailto:[email protected]";>subscribe</a> | <a href="http://mail-archives.apache.org/mod_mbox/karaf-issues/";>archives</a> ]</li> + </ul> + <h3 id="bugtracker">Bug Tracker, IRC, and CI</h3> + <ul class="community"> + <li><a href="https://issues.apache.org/jira/browse/KARAF";>Jira</a></li> + <li><a href="https://builds.apache.org/view/H-L/view/Karaf/";>Jenkins</a></li> + <li><a href="irc://irc.freenode.net/apache-karaf">#apache-karaf on Freenode</a></li> + </ul> </div> + + <div class="content--panel"> + <h2 id="contribute">Contribute</h2> + There are many ways you can help make Karaf a better piece of software - please dive in and help!<br/> + <ul class="community"> + <li>Try browsing the <a href="documentation.html">documentation</a> - if something's confusing or not clear, let us know.</li> + <li><a href="download.html">Download</a> the code & try it out and see what you think.</li> + <li><a href="https://github.com/apache/karaf";>Browse the source code</a>. Got an itch to scratch, want to tune some operation or add some feature ?</li> + </ul> + + If you'd rather have a more gentle introduction to working on the Karaf project, try looking at the test coverage report and help us get it even more green by supplying more test cases to get us closer to 100% coverage. + + <div class="content--panel--separator"></div> + + <h3 id="issue">Report bugs and feature requests</h3> + + <p>Did you find a bug or want something implemented? Please report an issue in our <a href="https://issues.apache.org/jira/browse/KARAF";>issue tracker</a>. When creating a bug make sure you document the steps to reproduce the issue and provide all necessary information like OS, versions your use, logs. When creating a feature request document your requirements first. Try to not directly describe the solution.</p> + + <p>If you want to dive into development yourself then you can also browse for open issues or features that need to be implemented. Take ownership of an issue and try fix it. Before doing a bigger change describe the concept/design of what you plan to do. If unsure if the design is good or will be accepted discuss it on the dev list.</p> + + <div class="content--panel--separator"></div> + + <h3 id="pull-request">Provide changes in a pull request</h3> + + The best way to provide changes is to fork karaf repo on github and provide a pull request with your changes. To make it easy to apply your changes please use the following conventions: + <ul class="community"> + <li>Every pull request should have a matching jira issue</li> + <li>Do the change in a branch that is named like the jira issue id e.g KARAF-1234.<br/>To create this branch you can use:<br/> + <code>git clone http://github.com/apache/karaf</code><br/> + <code>git fetch --all</code><br/> + <code>git checkout -b my-branch origin/master</code><br/> + Don't forget to periodically rebase your branch:<br/> + <code>git pull --rebase</code><br/> + <code>git push GitHubUser my-branch --force</code> + </li> + <li>Every commit in the branch should start with the jira issue id like this "[KARAF-123] More details"</li> + <li>You can squash your commits into one and force push your branch (not mandatory) using <code>git rebase -i apache/master</code></li> + <li>Test that your change works by adapting or adding tests.</li> + <li><a href="http://programmer.97things.oreilly.com/wiki/index.php/The_Boy_Scout_Rule";>Follow the boy scout rule to "Always leave the campground cleaner than you found it."</a></li> + <li>Make sure you do a build before doing a PR. The build has to be successfull:<br/> + <code> + mvn clean verify -Prelease -fae -T 1C + </code> + </li> + <li>If your PR has conflicts with the master then rebase the branch. PRs with conflicts are unlikely to be applied</li> + <li>Do not change too much in a PR. The smaller the PR the easier it is to apply and the faster it will be done</li> + <li>Sometimes PRs get lost. Do not hesitate to ask on the dev list if your PR seems to be ignored</li> + </ul> + + <div class="content--panel--separator"></div> + + <h3 id="review-pull-request">Review pull requests</h3> + + Anyone can review pull requests but the merge can be done only by a committer.<br/> + If you want to review a PR then comment with <code>R:@yourgithubid</code>. This marks that you will do the review and also apply if you are a committer.<br/> + When reviewing check if the changes are done in a clean way and are tested with a unit and possibly integration test. Check that the build does not report more test failures than before. If you are not a committer then write a comment if you recommend a merge or not. Provide good instructions for the contributor how to improve his PR if it is not yet ok. Make sure you do a review timely. By commenting that you do a review you kind of block others from applying the change.<br/> + NB: Jenkins performs a build for each pull request. You can trigger a new build on a pull request using "retest this please" in a PR comment. + + <div class="content--panel--separator"></div> + + <h3 ir="apply-pull-request">Apply pull requests</h3> + + This can obviously only be done by a committer. Do the following steps. + + <ul class="community"> + + <li>As one time config, you can rename your git remote and add apache one :<br/> + <code>git remote add apache https://git-wip-us.apache.org/repos/asf/karaf.git</code><br/><br/> + We recommand renaming <code>origin</code> as <code>github</code> :<br/> + <code>git remote rename origin github</code><br/><br/> + For <code>github</code> remote, add an additional fetch reference, which will cause every pull request to be made available as a remote branch in your workspace :<br/> + <code>git config --local --add remote.github.fetch '+refs/pull/*/head:refs/remotes/github/pr/*'</code><br/><br/> + You can confirm your configuration with the following command :<br> + <code>git remote -v</code><br> + <code>apache https://git-wip-us.apache.org/repos/asf/karaf.git (fetch)</code><br> + <code>apache https://git-wip-us.apache.org/repos/asf/karaf.git (push)</code><br> + <code>github https://github.com/apache/karaf.git (fetch)</code><br> + <code>github https://github.com/apache/karaf.git (push)</code><br> + <code>username [email protected]:username/karaf.git (fetch)</code><br> + <code>username [email protected]:username/karaf.git (push)</code> + </li> + + <li>Checkout the PR :<br/> + <code> + git fetch --all + git checkout -b pr-xxx github/pr/xxx + </code> + </li> + <li>Review the PR, amend, squash the commits, requesting changes, ... When done, add <code>LGTM</code> comment to approve the PR (or click on the "Approve" button on GitHub) :<br/> + <code>git rebase -i apache/master</code> + </li> + <li>Merge the PR (it automatically closes the PR) :<br/> + <code>git fetch --all</code><br> + <code>git checkout apache/master</code><br> + <code>git merge --no-ff -m "[KARAF-nnnn] This closes #xxx" pr-xxx</code><br> + <code>git push apache HEAD:master</code><br> + </li> + <li>Eventually backport commits to bugfix branches using <code>git cherry-pick</code></li> + <li>Make sure you document the fix in jira by adding the fix versions and resolve the jira issue</li> + <li>You can delete the PR branch : <code>git branch -D pr-xxx</code>.</li> + </ul> + + <div class="content--panel--separator"></div> + + <h3 id="improve karaf website">Improve the karaf website</h3> + + The content of the website http://karaf.apache.org is stored in the svn repo <a href="https://svn.apache.org/repos/asf/karaf/site/trunk";>karaf site</a>. See the <a href="https://svn.apache.org/repos/asf/karaf/site/trunk/README.md";>README.md</a> on top level for how to test and publish the website. + </div> + + <div class="content--panel"> + <h2 id="support">Support</h2> + If you are experiencing problems using Karaf then please report your problem to our <a href="https://issues.apache.org/jira/browse/KARAF";>issue tracker</a>. + You may also find it useful to discuss your issues with the community on the mailing lists or IRC.<br/><br> + <h3>How to get help</h3> + Whenever you are reporting a problem please be sure to include as much information as possible; the more we know the more chance of a quicker resolution. + <ul class="community"> + <li>which Karaf version you're using</li> + <li>what platform and JDK?</li> + <li>the particular OSGi container being used - if so what version</li> + <li>stack traces generally really help! If in doubt include the whole thing; often exceptions get wrapped in other exceptions and the exception right near the bottom explains the actual error, not the first few lines at the top. It's very easy for us to skim-read past unnecessary parts of a stack trace</li> + <li>log output can be useful too; sometimes enabling DEBUG logging can help</li> + <li>your code & configuration files are often useful. Be careful not to send us anything of a sensitive nature</li> + <li>did it work before, what have you changed to break it?</li> + <li>try upgrading to the latest release and see if it's fixed in that release</li> + <li>try the latest SNAPSHOT to see if it's fixed in that release</li> + <li>search the user mailing list to see if has been discussed before</li> + <li>check the issue tracker to see if the issue already have been reported</li> + </ul> + + <div class="content--panel--separator"></div> + + <h3>How to get help faster</h3> + We may be able to help you much more quickly if you try the following + <ul class="community"> + <li>provide us with a JUnit test case that demonstrates your issue. e.g. if you think you've found a bug, can you create a test case to demonstrate the bug ?</li> + <li>submit a patch fixing the bug! (we also buy you beer when we meet you if you submit bug fixes :) )</li> + <li>for memory leak or performance related issues, if you can run a profiler on your test case and attach the output as a file (or zipped file if it's huge) to the JIRA we can normally fix things much quickly. E.g. you could run jmap/jhat, JProfiler or YourKit on your code and send us the output. To find memory leaks it's quicker to resolve if you can tell us what classes are taking up all of the RAM; we can normally figure out what's wrong from that</li> + </ul> + + <div class="content--panel--separator"></div> + + <h3>Commercial Support</h3> + Apache Karaf is a widely used project. As such, several companies have built products and services around Karaf. + Companies are definitely encouraged to update this page directly or send a mail to the Karaf PMC with a description of your offerings and we can update the page. The products and services listed on this page are provided for information use only to our users. The Karaf PMC does not endorse or recommend any of the products or services on this page. + <ul class="community"> + <li><a href="https://www.codecentric.de/";>Codecentric</a> provides consulting and training for Apache Karaf and related technologies e.g. Apache Camel, Apache ActiveMQ and CXF for the DACH region.</li> + <li><a href="http://www.savoirtech.com/";>Savior Technologies, Inc</a> contributes and commits to the Apache Karaf project, while providing enterprise consulting, training and support for Karaf and a host of other Apache service containers. Savoir can provide best practice mentoring for developing with Karaf, as well as architectural/design reviews, troubleshooting and SOA infrastructure implementations.</li> + <li><a href="http://www.talend.com/";>Talend</a> uses and contributes on Apache Karaf. The Talend Runtime is based on Karaf. Talend has a dedicated team for the Apache projects. This team provides consulting, training, specific development, and support on Karaf (and other Apache projects).</li> + </ul> + </div> + + <div class="content--panel"> + <h2 id="team">Team</h2> + <table> + <thead> + <th>Name</th> + <th>ID</th> + <th>PMC</th> + <th>Organisation</th> + </thead> + <tbody> + <tr> + <td>David Bosschaert</td> + <td>davidb</td> + <td></td> + <td></td> + </tr> + <tr> + <td><a href="http://iocanel.blogspot.com/";>Ioannis Canellos</a></td> + <td>iocanel</td> + <td><img src="images/check.gif"/></td> + <td><a href="http://www.jboss.org/";>JBoss</a></td> + </tr> + <tr> + <td>Hiram Chirino</td> + <td>chirino</td> + <td></td> + <td><a href="http://www.jboss.org/";>JBoss</a></td> + </tr> + <tr> + <td>Chris Custine</td> + <td>ccustine</td> + <td><img src="images/check.gif"/></td> + <td></td> + </tr> + <tr> + <td>Andrea Cosentino</td> + <td>acosentino</td> + <td></td> + <td><a href="http://www.redhat.com/";>RedHat</a></td> + </tr> + <tr> + <td><a href="http://blog.code-house.org/";>Lukasz Dywicki</a></td> + <td></td> + <td></td> + <td></td> + </tr> + <tr> + <td><a href="http://freemanfang.blogspot.com/";>Freeman Fang</a></td> + <td>ffang</td> + <td><img src="images/check.gif"/></td> + <td><a href="http://www.jboss.org/";>JBoss</a></td> + </tr> + <tr> + <td>Jarek Gawor</td> + <td>jgawor</td> + <td><img src="images/check.gif"/></td> + <td><a href="http://www.ibm.com";>IBM</a></td> + </tr> + <tr> + <td>Christoph Gritschenberger</td> + <td>christophg</td> + <td></td> + <td></td> + </tr> + <tr> + <td><a href="http://icodebythesea.blogspot.com/";>Jamie Goodyear</a></td> + <td>jgoodyear</td> + <td><img src="images/check.gif"/></td> + <td><a href="http://www.savoirtech.com/";>Savoir Technologies</a></td> + </tr> + <tr> + <td>David Jencks</td> + <td>djencks</td> + <td><img src="images/check.gif"/></td> + <td><a href="http://www.ibm.com";>IBM</a></td> + </tr> + <tr> + <td>Alex Karasulu</td> + <td>akarasulu</td> + <td><img src="images/check.gif"/></td> + <td></td> + </tr> + <tr> + <td><a href="http://cmoulliard.blogspot.com/";>Charles Moulliard</a></td> + <td>cmoulliard</td> + <td><img src="images/check.gif"/></td> + <td><a href="http://www.jboss.org/";>JBoss</a></td> + </tr> + <tr> + <td><a href="http://notizblog.nierbeck.de/";>Achim Nierbeck</a></td> + <td>anierbeck</td> + <td><img src="images/check.gif"/></td> + <td><a href="http://codecentric.de/";>Codecentric</a></td> + </tr> + <tr> + <td><a href="http://gnodet.blogspot.com/";>Guillaume Nodet</a></td> + <td>gnodet</td> + <td><img src="images/check.gif"/></td> + <td><a href="http://www.jboss.org/";>JBoss</a></td> + </tr> + <tr> + <td><a href="http://blog.nanthrax.net";>Jean-Baptiste Onofre</a></td> + <td>jbonofre</td> + <td><img src="images/check.gif"/></td> + <td><a href="http://www.talend.com";>Talend</a></td> + </tr> + <tr> + <td>Andreas Pieber</td> + <td>pieber</td> + <td><img src="images/check.gif"/></td> + <td></td> + </tr> + <tr> + <td>James Strachan</td> + <td>jstrachan</td> + <td></td> + <td><a href="http://www.jboss.org/";>JBoss</a></td> + </tr> + <tr> + <td>Christian Schneider</td> + <td>cschneider</td> + <td></td> + <td><a href="http://www.talend.com";>Talend</a></td> + </tr> + <tr> + <td>Adrian Trenaman</td> + <td></td> + <td></td> + <td></td> + </tr> + <tr> + <td>Gert Vanthienen</td> + <td>gertv</td> + <td><img src="images/check.gif"/></td> + <td><a href="http://www.jboss.org/";>JBoss</a></td> + </tr> + <tr> + <td>Brian Topping</td> + <td>btopping</td> + <td></td> + <td></td> + </tr> + <tr> + <td>Heath Kesler</td> + <td>hkesler</td> + <td></td> + <td><a href="http://www.savoirtech.com/";>Savoir Technologies</a></td> + </tr> + </tbody> + </table> + </div> + </div> </div> + <div class="body--container container-fluid "></div> <footer class="footer"> <div class="container-fluid"> <div class="row-fluid"> <div class="span12"> - © <span>2016</span> <a href="http://www.apache.org";>Apache Software Foundation</a> - <a href="privacy.html">Privacy Policy</a><br/> - Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are trademarks of The Apache Software Foundation. + <div class="footer-documentation--text"> + © <span>2017</span> <a href="http://www.apache.org";>Apache Software Foundation</a> - <a + href="privacy.html">Privacy Policy</a><br/> + Apache Karaf, Karaf, Apache, the Apache feather logo, and the Apache Karaf project logo are + trademarks of The Apache Software Foundation.</div> </div> </div> </div>
