Contribute

How to Contribute

There are many ways to contribute to the ICEfpdf project:

• Participate in the forums.
• Test early access releases and provide your feedback.
• Report bugs, fix bugs, and contribute new features and enhancements.
• Integrate ICEpdf with other open source technologies.
• Develop new reference implementations.
• Translate ICEpdf documentation to other languages.
• Author tutorials, how-to articles, or blog about your experiences with ICEpdf.
• Share your ICEpdf applications with community members.

Become an ICEpdf Contributor

To become and ICEpdf 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:

1. Print out, review, and sign the ICEsoft Contributors Agreement.

2. Fax it to 1 (403) 663-3320 or email it to us.

3. The ICEpdf contributions administrator will review your agreement and grant you contributor status via your www.icefpdf.org user account. You will receive a confirmation email once your contributor status has been granted.

Submit a Contribution

Follow these steps to submit a contribution to ICEpdf:

1. Ensure that you have ICEpdf contributor status (see above).

2. If possible ensure that all code to be submitted is based on and tested against the latest ICEpdf 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. Email us your patch. Be sure to include the following:

• Your icepdf.org username.
• The icepdf.org JIRA issue key for the issue that relates to your patch, if there is one.
• A description of the contribution, what it fixes, adds, changes, etc.
• The contribution files attached as a .zip or .tar archive.
• Contributions must be sent from the same email address specified in your icepdf.org user account or they will be rejected.

5. You will receive a confirmation email that your contribution has been received.

6. A component owner will review your contribution, and send any comments or questions back to you.

7. If the contribution is accepted, an ICEpdf 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 ICEpdf Contributors list.

8. The accepted contribution will be available within 24 hours on the public SVN, and in the next bundle release of that ICEpdf branch.

We thank you in advance for your contributions.