[REQS-712] javadoc