Code comments.

code-comments-css.md

/***********************************************************************************
  SECTION TITLE
 **********************************************************************************/

.element {
  background:red;
}

/***********************************************************************************
  SECTION TITLE
 ***********************************************************************************

  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque ut ultrici
  diam. Cras ac neque facilisis, sodales augue in, ullamcorper ipsum. Donec nec da
  ibus dui. Curabitur interdum arcu ut mauris viverra adipiscing.

  <div class="foo">
    <p>Lorem</p>
  </div>

  Sodales augue in, ullamcorper ipsum. Donec nec dap ibus dui. Curabitur interdumr
  cu ut mauris viverra adipiscing.

 **********************************************************************************/

.element {
  background:green;
}

/**
  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque ut ultrici
  diam. Cras ac neque facilisis, sodales augue in, ullamcorper ipsum. Donec nec da
  ibus dui. Curabitur interdum arcu ut mauris viverra adipiscing.

  <div class="foo">
    <p>Lorem</p>
  </div>

  Sodales augue in, ullamcorper ipsum. Donec nec dap ibus dui. Curabitur interdumr
  cu ut mauris viverra adipiscing.
 */
.element {
  background:blue;
}

code-comments-html.md

<!--————————————————————————————————————————————————————————————————————————————————
  SECTION TITLE
  ———————————————————————————————————————————————————————————————————————————————-->
 
<div class="element"></div>

<!--————————————————————————————————————————————————————————————————————————————————
  SECTION TITLE
  ——————————————————————————————————————————————————————————————————————————————————

  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque ut ultrici
  diam. Cras ac neque facilisis, sodales augue in, ullamcorper ipsum. Donec nec da
  ibus dui. Curabitur interdum arcu ut mauris viverra adipiscing.

  <div class="foo">
    <p>Lorem</p>
  </div>

  Sodales augue in, ullamcorper ipsum. Donec nec dap ibus dui. Curabitur interdumr
  cu ut mauris viverra adipiscing.

  ———————————————————————————————————————————————————————————————————————————————-->
 
<div class="element"></div>

<!--
  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque ut ultrici
  diam. Cras ac neque facilisis, sodales augue in, ullamcorper ipsum. Donec nec da
  ibus dui. Curabitur interdum arcu ut mauris viverra adipiscing.

  <div class="foo">
    <p>Lorem</p>
  </div>

  Sodales augue in, ullamcorper ipsum. Donec nec dap ibus dui. Curabitur interdumr
  cu ut mauris viverra adipiscing.
  -->
<div class="element"></div>

code-comments-README.md

This is how I handle my code comments, there are 2 types:

• Section header (with optional additional comment(s))
• Regular comment(s)

All comments are limited to 80 characters per line with padding on each horizontal side consisting of two spaces.