The most important javadoc is the one in the outer API, cache, cache manager...etc. That's where we should focus on getting the javadocs right IMO.