james-server-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From btell...@apache.org
Subject [11/20] james-project git commit: JAMES-2315 Split contribution guide lines from community
Date Thu, 01 Feb 2018 10:44:44 GMT
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 <btellier@linagora.com>
Authored: Tue Jan 30 12:02:31 2018 +0700
Committer: benwa <btellier@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


Mime
View raw message