How to Contribute
There are many ways to contribute to an ICEsoft open source project:
- Participate in the forums.
- Test early access releases (alpha / beta) and provide your feedback.
- Report bugs, fix bugs, and contribute new features and enhancements.
- Integrate ICEsoft open source products with other tools, build systems, component libraries, etc.
- Translate ICEsoft documentation / Wiki entries to other languages.
- Author tutorials, how-to articles, or blog about your experiences with any of ICEsoft's products.
- Inspire other community members by showcasing your work or providing case studies on ICEsoft products.
Become an ICEsoft Contributor
To become and ICEsoft contributor you must complete the ICEsoft Contributors Agreement. It is only necessary to complete the agreement once. Follow these steps to apply for Contributor status:
- Print out, review, and sign the Contributors Agreement.
- Fax it to 1 (403) 663-3320 or email it to firstname.lastname@example.org.
- The ICEsoft contributions administrator will review your agreement and grant you contributor status via your www.icesoft.org user account. You will receive a confirmation email once your contributor status has been granted.
- Contributions that have been accepted will be credited with your name in the source code files. You can choose to contribute anonymously through your account settings under 'My Account'.
Submit a Contribution
Follow these steps to submit a contribution to ICEsoft:
- Ensure that you have ICEsoft contributor status (see above).
- If possible ensure that all code to be submitted is based on and tested against the latest version or software in the related SVN repository. Alternatively, code changes made against the most recent official release will also be accepted.
- 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.
- 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.
- Email email@example.com indicating your icesoft.org account name and the JIRA case number that you have made a contribution to.
- You will receive a confirmation email that your contribution has been received.
- If the contribution is accepted, an ICEsoft member with commit privileges will check the contribution in and notify you that your contribution has been committed.
The accepted contribution will be available within 24 hours on the public SVN, and in the next bundle release of the relevant product branch.