Задать вопрос
sHinE
@sHinE
веб-разработчик, php/js/mysql и сопутствующее
html

Комментирование CSS+HTML: стандарты, утилиты и т.п?

Для языков программирования есть возможность построить документацию на основании комментариев к коду, есть специальные инструменты и стандарты написания этих комметариев.


Вопрос такой — есть ли нечто подобное для HTML/CSS?


Вопрос общий — подойдут и ссылки на стандарты/правила документирования, и ссылки на утилиты (если такие есть в природе), и просто ваши мысли и соображения на эту тему.


Цель — получить документацию по шаблонам и стилям на основании комментариев.

P.S. сам я не верстальщик, поэтому если вы — верстальщик и считаете, что идея бредовая — тоже пишите (желательно с объяснением причин)
  • Вопрос задан
  • 3940 просмотров
Комментировать
Подписаться 7 Оценить Комментировать
Пригласить эксперта
Ответы на вопрос 3
kaluzhanin
@kaluzhanin
Для CSS есть даже проект стандарта: cssdoc и его (неполная) имплементация на ruby: css_doc. Насколько это востребованно, не скажу, но логика подсказывает, что раз этим кто-то занимается, значит это кому-то нужно.

По HTML — информации не имею, да и не думаю, что это нужно. Все-таки в CSS можно указывать, когда применять данный стиль, а HTML говорит сам за себя.
Ответ написан
Комментировать
Комментировать
@vitstr
Front-end developer
была статья по поводу cssdoc habrahabr.ru/blogs/css/87406/
Ответ написан
Комментировать
Комментировать
YAAP
@YAAP
Комментировать HTML — ИМХО бред. Код должен быть чистый. Другое дело — комментировать шаблоны (т.е. чтоб при рендеринге страницы все комменты удалялись и пользователям показывался чистый HTML)

CSS — аналогично, надо иметь 2 версии: 1-я форматированная, с комментами. 2-я (рабочая) — минимизированная (инструментов хватает) и, по возможности, сжатая.

По вашему вопросу рекомендую прочитать статью Наглядное комментирование вёрстки и комментарии к ней.
Но, опять же, стандартов там нет, там лишь мысли как это сделать поудобней.
Ответ написан
2 комментария
2 комментария
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Войти через центр авторизации
Похожие вопросы
Вакансии с Хабр Карьеры
Тестировщик-стажёр
ITooLabs • Тула
от 35 000 до 40 000 ₽
Fullstack PHP Developer
Smapse Education
от 40 000 до 65 000 ₽
Trainee - IT Support
move2usajobs.com LLC • Лос-Анджелес
от 2 000 до 4 000 $
Ещё вакансии
Заказы с Хабр Фриланса
Обучение моделированию процесса дуговой наплавки в CAE
25 апр. 2024, в 18:14
1500 руб./в час
Реализовать форму регистрации и авторизации на React
25 апр. 2024, в 18:13
1000 руб./за проект
Настроить и запустить email кампанию на Gmail
25 апр. 2024, в 17:54
30000 руб./за проект
Ещё заказы