How to Contribute

There are many ways to contribute to the ICEfaces project:

  • Participate in the forums.
  • Test early access releases and provide your feedback.
  • Report bugs, fix bugs, and contribute new features and enhancements.
  • Integrate ICEfaces with other tools, build systems, component libraries, etc.
  • Implement new components or contribute a new CSS theme for the ICEfaces Component Suite.
  • Translate ICEfaces documentation to other languages.
  • Author tutorials, how-to articles, or blog about your experiences with ICEfaces.
  • Share your ICEfaces applications with community members.

Become an ICEfaces Contributor

To become and ICEfaces contributor you must complete the ICEfaces Contributors Agreement. It is only necessary to complete the agreement once. Follow these steps to apply for Contributor status:

  1. Print out, review, and sign the  Contributors Agreement .
  2. Fax it to  1 (403) 663-3320 or email it to  contributions@icefaces.org .
  3. The ICEfaces contributions administrator will review your agreement and grant you contributor status via your  www.icefaces.org user account. You will receive a confirmation email once your contributor status has been granted.
  4. Contributions that have been accepted will be credited with your name and will be listed on the Community Contributors page. You can choose to contribute anonymously through your account settings under 'My Account'.

Submit a Contribution

Follow these steps to submit a contribution to ICEfaces:

  1. Ensure that you have ICEfaces contributor status (see above).
  2. If possible ensure that all code to be submitted is based on and tested against the latest ICEfaces version in the SVN repository. Alternatively, code changes made against the most recent official release will also be accepted.
  3. Please submit any code contributions as a unidiff format .patch file (use "diff -u" or the default output from "svn diff"). If your patch file is longer than 5 lines of changes, turn it into a zip or tar file. Otherwise, you can simply include it in your mail message.
  4. Attach your contribution (patch or other files) to a  JIRA case (previously existing or newly created if none already exists for the issue/feature). Be sure to include the following:
  • A description of the contribution, what it fixes, adds, changes, etc.
  • The contribution files attached as a .zip or .tar archive.
  • Note that all contributions must be attached to the JIRA using the same icefaces.org user account specified in the Contributor's Agreement that was previously submitted, or they will be rejected.
  1. Email  contributions@icefaces.org indicating your icefaces.org account name and the JIRA case number that you have made a contribution to.
  2. You will receive a confirmation email that your contribution has been received.
  3. If the contribution is accepted, an ICEfaces member with commit privileges will check the contribution in and notify you that your contribution has been committed. If this is your first contribution, your name will be added to the ICEfaces Contributors list.
  4. The accepted contribution will be available within 24 hours on the public SVN, and in the next bundle release of that ICEfaces branch.

 

 

© COPYRIGHT 2010 ICESOFT TECHNOLOGIES INC. POWERED BY  ICEfaces
Overview |Architecture |Component Suite |Ajax Push |Demos |Documentation |Tutorials |Case Studies |WebinarsPrivacy Policy |Support |Training |Services |Contact Us
Powered by ICEfaces