La idea de Javadoc era realmente buena: comentar el código de una forma que el mismo comentario puede servir para la creación de un manual de referencia. Hay varias herramientas que se generaron a partir de esta idea como doxygen o phpDocumentor, que usan incluso el marcador de comentario de documentación de Javadoc /** */.

La pregunta es ¿por qué Javadoc no evolucionó? Ni siquiera fue modernizado visualmente. Javadoc permite especificar una hoja de estilo para las páginas web que crea, pero esta opción se usa poco por lo que parece. ¿Todo perdido? ¡No! Una, sí, que hay en http://blog.codexion.com/2010/08/hoja-de-estilo-css-para-javadoc/.

Referencias

Artículos relacionados