Конечно, приятная на вид документация является плюсом, но для меня основное внимание следует уделить качеству контента: четкие, правильные и полные документы бесценны.
doclet.com содержит ссылки на многие страницы, посвященные Javadoc, это хорошая отправная точка для вашего исследования.