Javadoc: package.html o package-info.java

Al intentar crear comentarios Javadoc a nivel de paquete, ¿cuál es el método preferido? ¿Qué haces?

package-info.java

ProsMás nuevoContrasAbuso de una clase: las clases son para código, no solo para comentarios

package.html

ProsExtensión HTML significa que no es códigoResaltado de sintaxis en editores de texto / IDEContras¿Ninguna?

Para mí, siempre he usado Package.html. Pero me pregunto si es la elección correcta.

Respuestas a la pregunta(1)

Su respuesta a la pregunta