Porque hay que documentar el Código HTML

Resulta evidente en cuanto se consulta la documentación de las clases que proporciona en los paquetes que distribuye Oracle.

Es muy recomendable (casi obligatorio) que el programador documente el funcionamiento de las clases dentro del propio código. A partir de unos comentarios especiales, llamados comentarios de documentación, con la herramienta javadoc se genera un conjunto de páginas en HTML, por las que se puede navegar utilizando cualquier navegador Web.

Ejemplo de documentación de un Código en Java

[Documentación de una clase]

(https://javaparajavatos.wordpress.com/2016/12/28/ejemplo-de-documentacion-de-una-clase/)