Hier im Forum: Lange Zeilen nicht lesbar

[Gunnar Bittersmann]

@@Der Martin

nein, das ist weitgehend sinnfrei. Der Kommentar soll den Zweck der Anweisung beschreiben - also das, was der Programmierer sich dabei gedacht hat.
Ein Kommentar wie "i auf Startwert 0 setzen" ist nutzlos. Das sieht man auch schon am Code.

💯

Was ich kommentiere: Browser-Hacks.

Oder anderes, wo die Intention nicht so ohne Weiteres aus dem Code ersichtlich ist. Jüngstes Beispiel:

/* when there’s no author image, render metainfo text content inline */
.metainfo__text:first-child {
  > * {
    display: inline;
  }
  /* and when there’s slot content, put a separator after author credits */
  .metainfo__credits:not(:last-child)::after {
    content: '|';
    padding: 0 0.25em;
    font-weight: normal;
  }
}

Das darf man gerne seinem 4 Monate älteren Ich erläutern.

… dann müssen die Kommentare gut genug sein, dass ich mich in wenigen Minuten wieder zurechtfinde. Im Idealfall sogar jemand anders, der den Code übernehmen will/muss.

Zwischen seinem Ich nach 4 Monaten (vermutlich auch schon nach 2 Wochen) und jemand anderem besteht kein Unterschied.

LLAP 🖖