added javadoc: first draft