Anyone can contribute to the project, any new pull request is welcomed: bug fixes, new features or any other contribution of any kind.
However, if you consider contributing, try to follow the rules described below.
As a Java project, Ghost4J must follow the standard Java code convention , other rules are defined below.
Every source file of the project must include the following header:
/* * Ghost4J: a Java wrapper for Ghostscript API. * * Distributable under LGPL license. * See terms of license at http://www.gnu.org/licenses/lgpl.html. */
The initial author of each source file must appear in the class documentation comment. First name, last name and e-mail address of the author must be provided with the @author tag as described below:
@author Gilles Grousset (firstname.lastname@example.org)
Javadoc comments must be provided for every method in every class.
Code comments should be used to detail code logic when necessary (long or complicated method).
Every testable class added to the project must be tested by a unit test class.
What is meant by the testable class term is classes where methods logic may lead to different results. In this case, it is important to test at least that the method is working as expected under normal circumstances. Error case tests are not mandatory but are recommended. The choice of error cases to test is left to the developer.
Methods are not tested when: