rfellows / pentaho-coding-standards

Repository for IDE specific code-style formatters as well as the master CheckStyle template

Introduction to Pentaho Coding Standards

Pentaho enforces coding standards and style through the CheckStyle project ( http://checkstyle.sf.net ).

CheckStyle will soon be integrated into our build system. Until that time, you'll need to configure your IDE using the instructions below to to ensure your contributions conform to the standard.

Installation (Eclipse):

1. Install CheckStyle plugin http://eclipse-cs.sf.net/update/
2. Configure the plugin to use the pentaho_checkStyle.xml; give it the raw github URL: https://raw.githubusercontent.com/pentaho/pentaho-coding-standards/master/pentaho_checkStyle.xml
   (that will also dynamically retrieve the Pentaho suppressions.xml referenced in the checker)
3. Configure the Eclipse Code Formatter to use the attached pentaho_formatter.xml

The Eclipse CheckStyle plugin documentation my be helpful: http://eclipse-cs.sourceforge.net

Installation (IntelliJ):

1. Install the CheckStyle-IDEA plugin. (available in the default public repository)
2. Clone this repository to your machine.
3. Configure the CheckStyle-IDEA with pentaho_checkStyle.xml.
4. Copy the codeStyleSettings.xml into your IntelliJ project folder ( {{IdeaIntelliJProjectFolder}}/.idea/codeStyleSettings.xml). Overwrite if it's already there.
5. Open IntelliJ, set the Project Settings -> Code Style -> Scheme to "Project"

Additional Information

CheckStyle Tips - Learn how to suppress CheckStyle modules for select areas.