added javadoc for logic package