clean code: javadoc.