Improve Javadoc by mentioning requirements