Un
problema general de los desarrolladores con los comentarios es que no
se emplean de manera adecuada en una página Web. Alguna veces unos pocos
son suficientes y, si una página solamente necesita unos cuantos, no se
deberían añadir más. Otras veces, se necesitan más de los que se
realizan. El número de comentarios requeridos depende completamente del
tamaño y del ámbito del proyecto Web y si se trabaja solo o con otros
desarrolladores.
Sin
embargo, a veces los profesionales se dejan llevar y tienen tantas
etiquetas de comentarios que no se puede ver el flujo del código HTML.
Una pagina con un comentario que no se puede ver el flujo del código
HTML. Una página con un comentario largo detrás de cada etiqueta puede
actuar como un alambre de púas en un campo: seguirá tropezando con él y
no podrá llegar a su destino. Si se necesita un numero mayor de
comentarios para una página compleja, sitúelos juntos en un solo contenedor y luego otros desarrolladores podrán ver el código y entender como se utiliza.
Referencia: SANDERS, Bill. HTML5 El futuro de la Web. Madrid, Anaya multimedia, 2011.
