You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by bt...@apache.org on 2018/02/01 10:44:44 UTC
[11/20] james-project git commit: JAMES-2315 Split contribution guide
lines from community
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 <bt...@linagora.com>
Authored: Tue Jan 30 12:02:31 2018 +0700
Committer: benwa <bt...@linagora.com>
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: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org