So you are willing to contribute ? Awesome !
If you don't know where to start here are some info. There are tasks waiting on you in the various Jiras and ideas can always come directly from you. Willing to contibute a translation ? Some doc ? Some code ? Please start by letting everyone know
You will find some info about contributing at jboss.org/help but here you will find information specific to GateIn projects.
How do I contribute ?
There are several ways to contribute, it can be code contribution obviously but docs, improvment on the build mechanism, translations, feedback... are also very well appreciated. If you are willing to participate in the project, it would be helpful to hang out the #gatein IRC room.
Any code or doccontribution should start by creating a jboss.org account and .
The first contribution usually are patch files attached to Jira tasks or GIT pull requests, those patches will be applied by the developers team to check its quality, that it doesn't introduce a backward compatibility, that it follows the conventions... After a few patches that didn't require any editing we will gladly open the repository so you can directly write your changes.
Looking for ideas, check out our "specifications" here.
Before we can accept any code, transation or doc contribution, you will need to 'sign' the contributor agreement located here.
This is a mandatory step before we can include any patch or open the repository with write access.
Before opening a Jira, please use the user forum to validate the idea or bug, this will help us keeping the Jira clean.
Portlet Container component: https://jira.jboss.org/jira/browse/GTNPC
Common component: https://jira.jboss.org/jira/browse/GTNCOMMON
MOP component: https://jira.jboss.org/jira/browse/GTNMOP
WCI component: https://jira.jboss.org/jira/browse/GTNWCI
WSRP component: https://jira.jboss.org/jira/browse/GTNWSRP
If you want to be notified about all issues and all their updates you can subscribe to the mailing list: https://lists.jboss.org/mailman/listinfo/gatein-issues
If you don't subscribe to the list you will still receive notifications if you opened the issue, subscribed to watch the issue or are assigned the task.
There is a user forum for people to try to get their issue resolved, this is not a forum to receive support but a place for the community to help each other and share tips: http://community.jboss.org/en/gatein?view=discussions
There is also a forum for contributors, to discuss contributions or propose new ideas, the developer forum is located here: http://community.jboss.org/en/gatein/dev?view=discussions
If you want to be notified about all forum entried and their updates you can enable notifications on those forums (in the right column)
To discuss and participate to the development of GateIn: https://lists.jboss.org/mailman/listinfo/gatein-dev
To receive all Jiras notifications: https://lists.jboss.org/mailman/listinfo/gatein-issues
To receive all Hudson notifications: https://lists.jboss.org/mailman/listinfo/gatein-builds
We host project on github: https://github.com/gatein
Here are our GIT usage guidelines: https://community.jboss.org/wiki/GateInPortalGitContributionGuide
#gatein on freenode
All the documentation is using Docbook as the input format for documentation, it allows us to easily publish HTML in a single page, HTML in multiple pages, PDF and Eclipse Help file documentations.
The main documentation sources (docbook) can be found here.
GateIn uses the resource bundle mechanism of Java. To add a new language you would have to translate and add files into the various /locale/ directories of the portal.
You can either use the properties syntax such as: Resource.Key=My Translationif you use this syntax do not forget to encode the file using native2ascii.
You can also use the XML syntax (see the Arabic translation) <?xml version="1.0" encoding="UTF-8"?> <bundle> <Resource> <Key>My Translation</Key> </Resource> </bundle>
New languages must also be added in the descriptor of supported languages located at:
See: http://community.jboss.org/docs/DOC-14616 For more details.
Reformat only if really necessary
Please don't commit bug fixing and reformatting at the same time (Hard to stop what really fixed the issue)
When committing, use the following format as GIT message:
GTNPORTAL-xxx: Title of the Jira - Check for NPE - Throw InvalidArgumentException