JavaDoc and "How to use" review