Цитирую мой другой ответ в stackoverflow :
Недавно, выполнив обслуживание старого кода, я обнаружил, что использование комментариев в конце тега div действительно затрудняет комментирование больших разделов кода, поскольку в HTML нет вложенных тегов комментариев. Итак, я приобрел привычку изменять комментарии в скрытые области в конце больших блоков div.
<div class="modal fade" id="dialog_edit_group">
<div class="modal-dialog">
<div class="modal-content">
...HTML content here...
</div><span title=".modal-content" HIDDEN></span>
</div><span title=".modal-dialog" HIDDEN></span>
</div><span title=".modal #dialog_edit_group" HIDDEN></span>
<!--
<div class="modal fade" id="dialog_edit_group_OLD">
<div class="modal-dialog">
<div class="modal-content">
...HTML content here...
</div><span title=".modal-content" HIDDEN></span>
</div><span title=".modal-dialog" HIDDEN></span>
</div><span title=".modal #dialog_edit_group_OLD" HIDDEN></span>
-->
Я поместил туда атрибут HTML5 "HIDDEN", чтобы, если другие изменят его и по какой-то причине добавят текст, его содержимое обычно будет скрыто. Я сделал это ВСЕХ КОПИЯХ, чтобы они выделялись чуть больше, как будто бы они кричали «КОММЕНТАРИЙ ЗДЕСЬ! Да, он создает элемент DOM, который теперь должен поддерживаться браузером, но это небольшая цена, которую приходится платить во время интенсивной активной разработки веб-сайтов.
Использование «end div comments» как такового соответствует стандарту HTML, дает мне большую читабельность и позволяет использовать тег HTML-комментария для отключения больших блоков страницы, чтобы помочь в разработке. Может быть, это будет полезно и другим.