• class description
• package.html
• public, non-self-explanatory methods

Interface naming [required]

• Java Interfaces shall not contain a general interface prefix (unlike "IMyInterface")

Runtime config file location [recommended]

• configuration files for an application should be located in the classpath or an application directory in the user home directory

Documentation, general [required]

• use english language

XML tag naming [recommended]

• element name: first letter uppercase, camel case
• attribute name: lower case letters

File naming (except java sources) [recommended]

• only lower case letters, words separated by underscore ("_")

Testing (unit testing) [required]

• best: no platform specific tests, if not possible to avoid, define a "test suite" (see JUnit documentation) so test classes succeed on all systems

Library usage

• use of new libs in 52n-security-api and -apps modules has to be coordinated [required]
• logging: all new modules shall use commons-logging (e.g. instead of log4j)

Coding style best practices [recommended]

• exceptions & logging: only log error in catch block, if exception is not forwarded to avoid multiple exception logging
• [tbc]

Release Guidelines / branches