Reference Manual for Gracelets - 2.0.0.SP2SourceForge.net Logo
6.6 - Appendix : Get Involved
As with any open source project, community involvement is essencial to producing a stable, well rounded product. Gracelets is no exception.

At the moment what is mostly needed is testing and help with writing documentation. If you would like to help out in these areas please post what you would like to help out with in the Gracelets User Forum.

If you would like to get involved, report bugs, post patches, submit new ideas or mention your observations you are invited to do so. Below is a list of links you can use to do just that.

Getting the latest code

Gracelets is being developed with Eclipse 3.4. And all of the projects are ready to be checked out using Eclipse. In addition you will need the Groovy Eclipse plugin, the SVN Eclipse Plugin (subeclipse) and the Maven 2 Eclipse plugin.

You can get these plugins for Eclipse 3.4 by adding these eclipse add-ons (see Help menu, Software Updates):
  • Groovy Eclipse Plugin: http://dist.codehaus.org/groovy/distributions/update/
  • SVN Eclipse Plugin: http://eclipse.svnkit.com/1.2.x/
  • Maven 2 Eclipse Plugin: http://m2eclipse.sonatype.org/update-dev/
The SVN trunk for all Gracelets code: https://gracelets.svn.sourceforge.net/svnroot/gracelets

IMPORTANT: Before Gracelets 2.0.0 all standard gracelets related code was contained in a single SVN folder per version. From Gracelets 2.0.0 and onward there will be a more reusable and logical SVN repository structure in addition to the fact that all components (core, server, libraries, extensions, etc.,) will be using Maven 2.

The API and the implementation has now been separated. API changes should be much less common as implementation changes will be and this also easily allows other implementations to be developed simultaneously. API changes should not change between major versions once the API is considered stable.

SVN Repository Branch URL's
VersionStatusSVN BranchProject Type
1.3.0Stablehttps://gracelets.svn.sourceforge.net/svnroot/gracelets/stable-1.3.0Eclipse
1.3.0M1Stablehttps://gracelets.svn.sourceforge.net/svnroot/gracelets/stable-1.3.0M1Eclipse
Gracelets 2.0.0+ SVN Repository Layout
API 2.0.0Betahttps://gracelets.svn.sourceforge.net/svnroot/gracelets/api/2.0.0Eclipse/Maven
Standard Implementation 2.0.0Betahttps://gracelets.svn.sourceforge.net/svnroot/gracelets/implementation/standard/2.0.0Eclipse/Maven
Server 1.0Alphahttps://gracelets.svn.sourceforge.net/svnroot/gracelets/server/1.0Eclipse
Tools 1.0Alphahttps://gracelets.svn.sourceforge.net/svnroot/gracelets/tools/2.0.0Eclipse/Maven
Extension Code
The standard extensions are being stored in the 'extensions/standard' directory off the trunk. Since extensions must be compatible with the latest API but each extension has its own technology version number a layout has been created. Off the extensions directory you have the name of the extension, then the version of the Gracelets API it is compatibale with is a sub directory off the name of the extension. Each final directory is an Eclipse/Maven project. Under the API compatibility directory you have an indicator (usually a version number) of the technology being integrated and the extensions compatibility with it. So for instance, the JBoss Seam extension code is in the following SVN folder:
https://gracelets.svn.sourceforge.net/svnroot/gracelets/extensions/standard/jboss_seam/2.0.0/all

The above url implies that it is the extension that is compatible with the 2.0.0 API and should be compatible with all versions of JBoss Seam.

Library Code
The library code is stored in a similiar manner. For instance the JBoss Gracelet Library for Persistence Context resolution is in the following SVN folder:

https://gracelets.svn.sourceforge.net/svnroot/gracelets/libraries/standard/jboss/2.0.0/4.x

The above url implies that this code is the standard JBoss Gracelets library compatible with Gracelets 2.0.0 API and with JBoss AS versions 4.x (4.0, 4.2, 4.3, etc.,).

Gracelets Server
Any Gracelets server should be compatible with all versions of Gracelets, thus there should be no need for a compatibility matrix. The code for the server is under the 'server' SVN folder off the trunk and under that is the version of the server. Currently the 1.0.0 alpha version is located at:

https://gracelets.svn.sourceforge.net/svnroot/gracelets/server/1.0

Gracelets Tools
Gracelets tools are meant to complement development and testing of Gracelets applications. It is many times heavily integrated with the Gracelets API and thus under the 'tools' SVN folder (off the trunk) is the version of the API the tools are compatible with. The latest tools code is now under:

https://gracelets.svn.sourceforge.net/svnroot/gracelets/tools/2.0.0