If you're looking for documentation about the Grails source code see the Developer Documentation
, this page serves as a guideline to the processes for committers working on Grails. As Grails takes on more developers it is important that a process is followed so that that Grails maintains a high level of quality. This section details that process.
The Change Approval Process
Clearly not every great idea should be added directly to Grails, as a commiter you have a responsibility to inform others of new ideas before touching the codebase. The following process should be followed as a general rule:
- Send an email to the developer list with proposals of the change/new feature
- If the change is agreed (and ultimately the final decision is down to the Grails project lead Graeme) add a new JIRA issue.
- When committing the changes refer to the JIRA issue number in the commit comments, e.g. GRAILS-001
- Make sure you only do minor commits without approval
Testing and Continuous Integration
Testing is seen as crucial to the success of the project and Grails aims for maximum coverage. Before even thinking of committing anything make sure you have implemented sufficient unit tests
to cover the code.
It doesn't matter how complicated your unit tests become (and they're often more complicated than the code itself with Grails) they must exist and they must cover as much as possible.
Before committing to Grails make sure you run the entire
test suite against Grails and only commit once the test suite is passing.
Directly following your commit monitor the Continuous Integration
build server and ensure the build completes successfully. A broken build must be immediately corrected.
The continuous integration compiles and tests with JDK 1.4. Make sure not to use any Java 5 specifics.
Notes on current state of coverage
At the moment not every aspect of Grails is covered by a unit test. This will be corrected over time, but these guidelines are in place so the situation doesn't degrade as we are still in a position to be able to ensure Grails has a solid foundation for the future.