JAMES-2315 Split contribution guide lines from community This moves intend:
- To move contribution as a TLD concern on the main webpage - Details more the way to contribute - Clearly expose git[hub] is for contributing and not a way to ship the product Project: http://git-wip-us.apache.org/repos/asf/james-project/repo Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/f409e0d7 Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/f409e0d7 Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/f409e0d7 Branch: refs/heads/master Commit: f409e0d72a56b71c6b9f506aa68acd3daf5629f5 Parents: 0f204e7 Author: benwa <[email protected]> Authored: Tue Jan 30 12:02:31 2018 +0700 Committer: benwa <[email protected]> Committed: Thu Feb 1 17:35:51 2018 +0700 ---------------------------------------------------------------------- src/homepage/index.html | 131 +++++++++++++++++++++++++++++++------------ 1 file changed, 95 insertions(+), 36 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/james-project/blob/f409e0d7/src/homepage/index.html ---------------------------------------------------------------------- diff --git a/src/homepage/index.html b/src/homepage/index.html index 066f196..a45d902 100644 --- a/src/homepage/index.html +++ b/src/homepage/index.html @@ -44,6 +44,7 @@ layout: default <li><a href="#first">Get Started</a></li> <li><a href="#posts">Last Posts</a></li> <li><a href="#second">Community</a></li> + <li><a href="#third">Contribute</a></li> <li><a href="#use-cases">Use-cases</a></li> <li><a href="documentation.html"><span class="fa fa-external-link"></span> Documentation</a></li> </ul> @@ -142,9 +143,7 @@ WHAT WILL YOU TRY:</b><br> <section> <p class="align-left"> Apache James Project is an Open Source all-volunteer project obtaining its strength from its Community made of developers and users. All are welcome to the Community!<br> - That way, we recommend that Users, Developers, Curious and Fans join the James Community.<br> - Here are the different ways of contributing sorted in order of increasing level of expertise you need to use them: - </p> + That way, we recommend that Users, Developers, Curious and Fans join the James Community.</p> <ul class="no-padding no-margin"> <li class="post-template center-icon"> <a href="https://james.apache.org/mail.html"; alt="mailing list james"><span class="icon fa-envelope"></span></a> @@ -152,17 +151,18 @@ WHAT WILL YOU TRY:</b><br> <b>Mailing list:</b> <br/>Subscribe to the appropriate <a href="https://james.apache.org/mail.html"; class="comm" alt="mailing lists">Mailing Lists</a> according to your interests and your profile.<br/> <a href="https://james.apache.org/mail.html#Guidelines"; class="comm" alt="mail guideline">Mail guidelines</a> explain you more precisely how it works. </span> - </li><li class="post-template center-icon"> - <a href="https://james.apache.org/mail.html"; alt="Gitter chat room"><span class="icon fa-wechat"></span></a> - <span class="details"> + </li> + <li class="post-template center-icon"> + <a href="https://james.apache.org/mail.html"; alt="Gitter chat room"><span class="icon fa-wechat"></span></a> + <span class="details"> <b>Gitter chat room:</b> <br/>Chat in live with the community on <a href="https://gitter.im/apache/james-project"; class="comm" alt="Gitter chat room">Gitter chat room</a>. </span> - </li> + </li> <li class="post-template center-icon"> <a href="https://issues.apache.org/jira/browse/JAMES/?selectedTab=com.atlassian.jira.jira-projects-plugin:summary-panel";><span class="icon fa-bug"></span></a> <span class="details"> - <b>Bug tracker:</b> + <b>Report bugs:</b> <br/>You can here enter bug encountered, share your point of view about a specific feature or anything else... <br/> Each subproject has its own bug tracker.<br/> <a href="https://issues.apache.org/jira/browse/JAMES/?selectedTab=com.atlassian.jira.jira-projects-plugin:summary-panel"; class="comm" alt="James Server bugtracker">Go to James Server project bugtracker</a>.<br/> @@ -170,55 +170,114 @@ WHAT WILL YOU TRY:</b><br> </span> </li> <li class="post-template center-icon"> - <a href="https://github.com/apache/james-project";><span class="icon fa-git"></span></a> + <a href="http://twitter.com/ApacheJames"; alt="twitter account"><span class="icon fa-twitter"></span></a> <span class="details"> - <b>Sources on Git:</b> - <br/>Read our sources from the <a href="git://git.apache.org/james-project.git" class="comm" alt="James Git sources">Apache Git</a>.<br/> - You can also come and interact with us on <a href="https://github.com/apache/james-project"; class="comm" alt="James on GitHub">GitHub</a>.<br/> + <b>Twitter:</b> + <br/>Express yourself and follow us <a href="http://twitter.com/ApacheJames"; class="comm" alt="twitter account">@ApacheJames</a>. </span> </li> <li class="post-template center-icon"> - <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20newbie%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC"; alt="contribute to the code"><span class="icon fa-cogs"></span></a> + <a href="http://james.apache.org/download.cgi"; alt="Downloads"><span class="icon fa-cloud-download "></span></a> <span class="details"> - <b>Get started and contribute to this project:</b> - <br/>James is a project that lives from the contributions of its community! Read the <a href="/contribute.html" class="comm" alt="Contributing to James: guidelines">contributing guidelines</a>. - <br/>We more than welcome <b>articles</b> and <b>blog posts</b> about James. Contact us by <a href="https://james.apache.org/mail.html"; class="comm" alt="mailing lists">email</a> or on <a href="https://gitter.im/apache/james-project"; class="comm" alt="Gitter chat room">Gitter</a> to share your experiences. - <br/><b>Documentation</b> is an easy way to get started, and more than wanted! Check out the <a class="comm" alt="Documentation" href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20documentation%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC";>~documentation</a> label on JIRA. - <br/>And to get started with <b>code contributions</b>, search out the - <a class="comm" alt="Newbie tasks" href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20newbie%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC";>~newbie</a>, - <a class="comm" alt="Easy fixes" href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20easyfix%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC";>~easyfix</a>, - <a class="comm" alt="Cool features" href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20feature%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC";>~feature</a> labels on JIRA</a>. - <br/>There is many other ways one can help us: packaging, communication, etc . . . + <b>Download Apache James releases:</b> + <br/>Our <a href="http://james.apache.org/download.cgi";>download page</a> allows you to download artifacts and sources for the James Server and James libraries. </span> </li> <li class="post-template center-icon"> - <a href="http://www.apache.org/security/"; alt="Report security vulnerabilities"><span class="icon fa-shield "></span></a> + <a href="http://james.apache.org/support.html"; alt="Professional support"><span class="icon fa-briefcase"></span></a> <span class="details"> - <b>Reporting security vulnerabilities:</b><br/> - <a class="comm" alt="Security" href="http://www.apache.org/security/";>Security</a>: Vulnerabilities should be announced to the Apache Security team.<br/> - PMCs will be notified about them, and will work hard to propose fixes as fast as possible. + <b>Professional support:</b> + <br/>Find a list of companies which can provide you some <a href="http://james.apache.org/support.html"; class="comm" alt="Professional support"> + support on James</a>. </span> </li> + </ul> + </section> + </section> + <section id="third" class="main"> + <header class="major"> + <h2>Contribute </h2> + </header> + <section> + <p class="align-left"> + James is a project that lives from the contributions of its community.<br/> + <b>Anyone can contribute!</b> That's right, we always want to hear from people with contributions to the code, the documentation, the website, and bug reports. <br> + We more than welcome non-coding contributions.<br> + Here are the different ways of contributing: + </p> + <ul class="no-padding no-margin"> <li class="post-template center-icon"> - <a href="http://twitter.com/ApacheJames"; alt="twitter account"><span class="icon fa-twitter"></span></a> + <a href="http://www.apache.org/licenses/";><span class="icon fa-copyright "></span></a> <span class="details"> - <b>Twitter:</b> - <br/>Express yourself and follow us <a href="http://twitter.com/ApacheJames"; class="comm" alt="twitter account">@ApacheJames</a>. + <b>Licenses:</b> + <br/>All contributions to the James project are made under the <a class="comm" alt="License" href="http://www.apache.org/licenses/";>Apache license 2.0</a><br/> </span> </li> <li class="post-template center-icon"> - <a href="http://james.apache.org/download.cgi"; alt="Downloads"><span class="icon fa-cloud-download "></span></a> + <a href="https://james.apache.org/mail.html";><span class="icon fa-bullhorn "></span></a> <span class="details"> - <b>Download Apache James releases:</b> - <br/>Our <a href="http://james.apache.org/download.cgi";>download page</a> allows you to download artifacts and sources for the James Server and James libraries. + <b>Join the community:</b> + <br/>We more than welcome <b>articles</b> and <b>blog posts</b> about James.<br/> + Contact us by <a href="https://james.apache.org/mail.html"; class="comm" alt="mailing lists">email</a> or + on <a href="https://gitter.im/apache/james-project"; class="comm" alt="Gitter chat room">Gitter</a> to share your experiences. + <br/>Don't hesitate to promote the Apache James project on your preferred medias. + <br/>Report your bugs, propose enhancements on our <a href="https://issues.apache.org/jira/browse/JAMES/?selectedTab=com.atlassian.jira.jira-projects-plugin:summary-panel"; class="comm" alt="James Server bugtracker">bugtracker</a>. </span> </li> + <li class="post-template center-icon"> - <a href="http://james.apache.org/support.html"; alt="Professional support"><span class="icon fa-briefcase"></span></a> + <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20documentation%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC";><span class="icon fa-book "></span></a> <span class="details"> - <b>Professional support:</b> - <br/>Find a list of companies which can provide you some <a href="http://james.apache.org/support.html"; class="comm" alt="Professional support"> - support on James</a>. + <b>Documentation:</b><br/> + Documentation is an easy way to get on board! <br/> + Check out the <a class="comm" alt="Documentation" href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20documentation%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC";>~documentation</a> label on JIRA to get some ideas.<br/> + Report on JIRA the typo you spots, the information you miss, and any improvement you can think to.<br/> + The next step is to contribute the documentation changes via <a class="comm" alt="The website on github" href="https://github.com/apache/james-project/tree/master/src/site/xdoc";>Git</a>. + </span> + </li> + + <li class="post-template center-icon"> + <a href="https://github.com/apache/james-project";><span class="icon fa-git"></span></a> + <span class="details"> + <b>How to contribute code changes:</b> + <br/>Read our sources from the <a href="git://git.apache.org/james-project.git" class="comm" alt="James Git sources">Apache Git</a>.<br/> + You can also come and interact with us on <a href="https://github.com/apache/james-project"; class="comm" alt="James on GitHub">GitHub</a>.<br/> + On <a href="https://github.com/apache/james-project"; class="comm" alt="James on GitHub">GitHub</a> you can share your work by creating a pull request.<br/> + Alternatively, you can attach a patch to the JIRA issue.<br/> + After a review, and exchanges with you, a Apache James developer will integrate the changes to the code base once it matches our policies. + </span> + </li> + + <li class="post-template center-icon"> + <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20newbie%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC"; alt="contribute to the code"><span class="icon fa-cogs"></span></a> + <span class="details"> + <b>What contributions can you do:</b> + <br/>We reference some easy tasks to start with : + <a class="comm" alt="Newbie tasks" href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20newbie%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC";>~newbie</a> + <br/> We have a collection of minor fixes awaiting contributions: + <a class="comm" alt="Easy fixes" href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20easyfix%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC";>~easyfix</a> + <br/> Challenge yourself with some cool features we thought to: + <a class="comm" alt="Cool features" href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20JAMES%20AND%20resolution%20%3D%20Unresolved%20AND%20labels%20%3D%20feature%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC";>~feature</a> + <br/>Additional ideas are more than welcome. Don't hesitate to discuss that with us! + </span> + </li> + <li class="post-template center-icon"> + <a href="http://www.apache.org/security/"; alt="Report security vulnerabilities"><span class="icon fa-shield "></span></a> + <span class="details"> + <b>Reporting security vulnerabilities:</b><br/> + <a class="comm" alt="Security" href="http://www.apache.org/security/";>Security</a>: Vulnerabilities should be announced to the Apache Security team.<br/> + PMCs will be notified about them, and will work hard to propose fixes as fast as possible.<br/> + Specific details about security in James can be found <a class="comm" alt="security in James" href="http://james.apache.org/server/feature-security.html";>here</a>. + </span> + </li> + <li class="post-template center-icon"> + <a href="http://james.apache.org/contribute.html"; alt="Additional information"><span class="icon fa-info-circle "></span></a> + <span class="details"> + <b>Additional information:</b><br/> + The <a class="comm" alt="More details about contributing" href="http://james.apache.org/contribute.html";>contribute</a> page contains more details about the various details exposed above.<br/> + To match the quality expectations of our community, we enforce <a class="comm" alt="Coding Standards" href="http://james.apache.org/contribute.html#Coding_Standards";>coding standards</a>.<br/> + We rely on <a class="comm" alt="checkstyle" href="https://github.com/apache/james-project/blob/master/checkstyle.xml";>checkstyle</a> for style checking.<br/> + Amongst other common practices: every file should start with the Apache License, code changes should be covered by tests. . . </span> </li> </ul> --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
