Какие комментарии ставить в html и css?

Question

[Август Милович]

Здраствуйте! У меня появился такой вопрос: я несколько раз видел чужой html и css код, и там везде стоят комментарии. Хотелось бы понять когда нужны комментарии, а когда нет. Я имею ввиду с каким интервалом ставить комментарии? Каждый блок, или подуровни тоже? Объясните пожалуйста на примере вот такой верстки:

<header>
    <div class="div1">text1</div>
    <div class="div2">text2</div>
</header>
<article>
    <div class="maintext">Main text</div>
</article>
<article>
    <h1>H1</h1>
    <section>
        <div>text1</div>
    </section>
    <section>
        <div>text2</div>
    </section>
</article>
<footer>
    <nav>
        <p class="p1">12312</p>
        <p class="p2">3123213</p>
    </nav>
    <section>
        Info
    </section>
</footer>

Она немного кривая, но так даже лучше. И всем заранее спасибо)

Answer 1

[Никита Юдин]

Если вы верстаете по БЭМ, и пишите понятные имена классов, к тому же используете семантическую вёрстку, то комментарии в html вообще не нужны

Answer 2

[ReActor Дмитрий Вершанский]

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