update javadoc rules-commons
add explaination to javadoc