Что такое комментарий на языке гипертекстовой разметки (html comment)? - определение из техопедии

Определение. Что означает комментарий к языку разметки гипертекста (комментарий HTML)?

Комментарий на языке гипертекстовой разметки (HTML-комментарий) написан веб-разработчиком и используется в качестве справочного материала при разработке проекта. Разработчик может просматривать комментарии HTML во время разработки, но этот код не виден пользователям сайта. Комментарии могут быть включены во многие типы файлов, включая HTML, XML и CSS.

HTML-комментарии обычно используются для объяснения сложных структур таблиц или предоставления документации по проекту разработки.

Techopedia объясняет комментарий языка разметки гипертекста (комментарий HTML)

Большинство языков программирования и сред содержат комментарии, которые могут выполнять любую из следующих функций:

• Метод описания и упрощения сложной части проекта
• Предлагая больше деталей о том, почему код написан особым образом, позволяя разработчикам понимать друг друга
• Разрешение неподтвержденного кода быть временно пропущенным без удаления

Последняя из перечисленных функций весьма полезна, когда неподтвержденный код проверяется, а затем превращается в существенную часть проекта. Когда это происходит, разработчик удаляет символы комментария, и ранее скрытый код становится функциональным.

Есть множество рекомендаций по написанию комментариев. Например, разработчики должны использовать простые слова как можно чаще, так как комментарий предназначен для того, чтобы сделать код более понятным. Перед продолжением проекта все предыдущие комментарии должны быть перепроверены.

Некоторые инструменты разработчика поддерживают легкое включение комментариев. Примерами инструментов являются заметки на странице Dreamweaver и сводка файла FrontPage.