svn commit: r1180465 - /incubator/jena/site/trunk/content/jena/getting_involved/index.mdtext

[ca...@apache.org]

Author: castagna
Date: Sat Oct  8 19:12:59 2011
New Revision: 1180465

URL: http://svn.apache.org/viewvc?rev=1180465&view=rev
Log: (empty)

Modified:
    incubator/jena/site/trunk/content/jena/getting_involved/index.mdtext

Modified: incubator/jena/site/trunk/content/jena/getting_involved/index.mdtext
URL: http://svn.apache.org/viewvc/incubator/jena/site/trunk/content/jena/getting_involved/index.mdtext?rev=1180465&r1=1180464&r2=1180465&view=diff
==============================================================================
--- incubator/jena/site/trunk/content/jena/getting_involved/index.mdtext (original)
+++ incubator/jena/site/trunk/content/jena/getting_involved/index.mdtext Sat Oct  8 19:12:59 2011
@@ -1,21 +1,49 @@
 Title: Getting involved in Apache Jena
 
-The Jena project team welcomes contributions from the community towards making
-Jena a better platform for semantic web and linked data applications. We
-welcome feature suggestions, bug reports and patches for code or documentation.
+We welcome your contribution towards making Jena a better platform for semantic web and linked data applications. 
+We appreciate feature suggestions, bug reports and patches for code or documentation.
 
 If you need help using Jena: please see our [getting help](../help_and_support) page.
 
 ### How to contribute
-Please add suggestions, bug reports, feature requests and code contributions (as patches)
-to the Jena issue tracker: [issues.apache.org/jira/browse/JENA](https://issues.apache.org/jira/browse/JENA).
 
-Feel free to discuss your contribution, before or after adding it to Jira, on
-the [`jena-dev@incubator.apache.org`](mailto:jena-dev@incubator.apache.org) mailing list.
-Subscription instructions [here](../help_and_support).
+You can help us sending your suggestions, feature requests and bug reports (as well as patches) using the Jena issue tracker: 
+[issues.apache.org/jira/browse/JENA](https://issues.apache.org/jira/browse/JENA).
 
+Feel free to discuss your contribution, before or after adding it to Jira, on the [`jena-dev@incubator.apache.org`](mailto:jena-dev@incubator.apache.org) mailing list.
+You can help other users answering to their question on the [`jena-users@incubator.apache.org`](mailto:jena-users@incubator.apache.org) mailing list. 
+Subscription instructions [here](../help_and_support).
 
 ### Subversion repository
-The Jena source code repository be found in Subversion at [incubator/jena](http://svn.apache.org/repos/asf/incubator/jena/Jena2/).
-This is now the authoritative, active repository for Jena code. The historical Jena sources are still
-available from [SourceForge](http://sf.net/projects/jena).
+
+The Jena source code be found in Apache Subversion repository: [http://svn.apache.org/repos/asf/incubator/jena/Jena2/](http://svn.apache.org/repos/asf/incubator/jena/Jena2/).
+This is now the authoritative, active repository for Jena code. The historical Jena sources are still available from [SourceForge](http://sf.net/projects/jena).
+
+Each Jena module uses Maven, here is how you can check out, build and test a Jena module:
+
+  svn co https://svn.apache.org/repos/asf/incubator/jena/Jena2/TDB/trunk TDB
+  cd TDB
+  mvn clean package
+
+Some Jena developers hang out on #jena on irc.freenode.net.
+
+### Submit your patches
+
+Patches should be attached to issues in Jira (click on `More Actions > Attach Files`). 
+To create a patch you can simply use the command: 
+
+    svn diff > JENA-XYZ.patch
+
+Please, inspect your patch and make sure it includes all (and only) the relevant changes for a single issue. Don't forget tests!
+If you want to test if a patch applies cleanly you can use: 
+
+    patch -p0 < JENA-XYZ.patch 
+
+If you use Eclipse: right click on the project name in `Package Explorer`, select `Team > Create Patch` or `Team > Apply Patch`. 
+
+### How Apache Software Foundation works
+
+Apache Jena is an incubating Apache project and to better understand how to get involved and how the Apache Software Foundation works we recommend you read:  
+
+ * [http://www.apache.org/foundation/getinvolved.html](http://www.apache.org/foundation/getinvolved.html)
+ * [http://www.apache.org/foundation/how-it-works.html](http://www.apache.org/foundation/how-it-works.html)