Komentēt nevajag visu, bet gan tikai tās vietas, kuras cilvēkam, kurš lasīs tavu kodu, var sagādāt neskaidrības, jo koda autors "ir tups".
Piemērs no tava koda:
if (substr($data, 0, 7) == 'x0cser:')
Komentāram tur ir jābūt un tam ir jāpaskaidro nevis ko tas koda dara ('what'), bet kāpēc tas tur ir un ar kādu mērķi ('why').
> Argumenti?
Labāk pastāsti kāpēc kods nav jākomentē.