Page History
Wiki Markup |
---|
{rate} h2. Code style Magnolia contributors are kindly request to follow these simple conventions below: * [Standard Java coding conventions|http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html] * Tab policy: spaces only (!) * Indentation: 4 spaces * Maximum line width: 120 (no strong rule here - don't put exceptions declarations on new lines just to respect this, for instance) * We preferably don't use abbreviations in classnames (only exception to that rule is _MgnlSomething_) * Read http://dev.magnolia-cms.com/~gjoseph/on-code-readability Also ensure that you have the right license headers in place ! See the file attached for Eclipse Preferences (which you can simply import and everything should be done). * [Formatting|Code style and Javadoc^eclipse-format-settings.xml] * [Code Templates|Code style and Javadoc^eclipse-codetemplates.xml] {children}.. or see [Checkstyle for Eclipse]. (similar instructions apply for IntelliJ) h2. Javadoc * Class-level documentation is mandatory. * First sentence of any Javadoc comment must finish with punctuation. (This is/was needed for summary pages/tables to include the first sentence next to the described element) * DRY. * See http://dev.magnolia-cms.com/~gjoseph/on-code-readability |
Overview
Content Tools