svn commit: r1639263 - /directory/site/trunk/content/contribute.mdtext

[pi...@apache.org]

Author: pierresmits
Date: Thu Nov 13 07:56:59 2014
New Revision: 1639263

URL: http://svn.apache.org/r1639263
Log:
JIRA issue DIR-311: rewording of the 'contribute' page to make it more appealing and inviting to participate.

Modified:
    directory/site/trunk/content/contribute.mdtext

Modified: directory/site/trunk/content/contribute.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/contribute.mdtext?rev=1639263&r1=1639262&r2=1639263&view=diff
==============================================================================
--- directory/site/trunk/content/contribute.mdtext (original)
+++ directory/site/trunk/content/contribute.mdtext Thu Nov 13 07:56:59 2014
@@ -18,28 +18,48 @@ Notice: Licensed to the Apache Software 
 
 # Join the Apache Directory Community
 
-The Apache Directory Project is an [Open Source](http://www.opensource.org) volunteer project under the auspices of [The Apache Software Foundation (ASF)](http://www.apache.org). We welcome your input and contributions - either with direct participation (coding, documenting, answering questions, proposing ideas, reporting bugs, suggesting bug-fixes, etc..). You can also contribute to [The Apache Software Foundation (ASF)](http://www.apache.org) by [resource donations](http://apache.org/foundation/contributing.html) (money, time, publicity, hardware, software, conference presentations, speeches, etc...) of through [the sponsorship program](http://apache.org/foundation/sponsorship.html) .
+First of all, a big **thank you** from us for evaluating and/or using our products. We truly appreciate it. Our products exist, and continue to improve thanks to you. But you can help us and yourself more!
 
-To begin with, we suggest you to subscribe to the [Directory Mailing Lists & IRC](mailing-lists-and-irc.html) (follow the link for information on how to subscribe and to access the mail list archives). Listen-in for a while, to see how others make contributions.
+As we are a community of volunteers working with the guidelines and policies of the Apache Software Foundation (the Apache Way) in mind, we **welcome** any kind of input you can provide to get better products. These contributions, whether you think of reporting bugs, supplying code enhancements, improvements to our documentation, answering questions in our mailing lists or anywhere else are valuable to us. Because these will help us in helping you.
 
-Then you can :
+You can also consider **donating** in other ways to the Apache Software Foundation. Look for more information on that subject at this page: [resource donations](http://apache.org/foundation/contributing.html).
 
-* Answer questions posted to the mailing lists.
-* Contribute to the FAQ or Wiki.
-* Contribute other documentation patches, either for the website or for the Apache Directory user documentation.
-* Investigate bugs that have been reported and provide patches where appropriate.
-* Help with development for the next release of the Directory project and subprojects.
+So, you consider contributing to our project. But how do you go about achieving this?
 
-## What we are looking for
+Well, it is as easy as pie. The first thing youÕll need to do is **subscribe** to one of our mailing lists (see the overview below) and youÕre set to go to deliver your first contribution: a posting there, about how great our products are, what you found missing, or even the bug you got confronted with. You might even consider a more interactive approach and join the team on our IRC channel.
 
-* Source code and fixes contributions
+After you have had your first contribution over and done with, it stays **easy**. You can:
+* reply to questions, and/or share your viewpoint on how issues could get resolved
+* add to our FAQs or WIKI
+* share your code and documentation patches through our issue management solution [JIRA](issue-tracking.html)
+* evaluate bugs and proposed improvements provided by others within our team
+* help with outlining and evaluating the future direction of our project and the development iterations of our products.
+
+To make it more explicit, we are looking for:
+* Source code (bugs and improvements) contributions
 * Documentation assistance
 * Product and feature suggestions
-* Detailed and constructive feedback
-* Articles and white papers
+* Detailed and/or constructive feedback
+* Articles (case studies, white papers, etc) and presentations (speeches) about how our products helped you.
+
+But the list is not limited to the above! If you feel we missed something there, please **let us know**.
+
+## Mailing lists and IRC channels
+| Name | Subscribe | Post | Archive |
+|---|:-:|:-:|:-:|
+| The Directory Developers List | [Subscribe](mailto:dev-subscribe@directory.apache.org) | [Post](mailto:dev@directory.apache.org) | [mail-archives.apache.org](http://mail-archives.apache.org/mod_mbox/directory-dev) |
+| The Directory Users List| [Subscribe](mailto:users-subscribe@directory.apache.org) | [Post](mailto:users@directory.apache.org) | [mail-archives.apache.org](http://mail-archives.apache.org/mod_mbox/directory-users)  |
+| The Directory Commits List | [Subscribe](mailto:commits-subscribe@directory.apache.org) | — | [mail-archives.apache.org](http://mail-archives.apache.org/mod_mbox/directory-commits) |
+| The LDAP API List | [Subscribe](mailto:api-subscribe@directory.apache.org) | [Post](mailto:api@directory.apache.org) | [mail-archives.apache.org](http://mail-archives.apache.org/mod_mbox/directory-api) |
+| The Fortress List | [Subscribe](mailto:fortress-subscribe@directory.apache.org) | [Unsubscribe](mailto:fortress-unsubscribe@directory.apache.org) |
+
+Our IRC channels on free node.net are:
+* [#apache-directory](irc://irc.freenode.net/apache-directory)
+* [#apache-directory-dev](irc://irc.freenode.net/apache-directory-dev)
+* [#apache-fortress](irc://irc.freenode.net/apache-fortress)
+
+For more information about our mailing lists and IRC channels, check out: [mailing lists](mailing-lists-and-irc.html).
 
-## How do I contribute
+Again, we thank you and look forward to seeing your first contribution.
 
-* To discuss Apache Directory topics check out the [mailing lists](mailing-lists-and-irc.html).
-* Informal discussion also occurs on the [#apache-directory](irc://irc.freenode.net/apache-directory) Users IRC channel or on the [#apache-directory-dev](irc://irc.freenode.net/apache-directory-dev) Developers IRC channel on [freenode.net](http://freenode.net).
-* Bugs and other issues can be posted on the project [issue tracking system](issue-tracking.html).
+**The Apache Directory Community**
\ No newline at end of file