Oczywiście, że dobry kod wymaga komentarzy. Co najmniej JavaDoc/PHPDoc/JSDoc/odpowiednik musi się znaleźć. Dodatkowo warto czasami w dużych produktach oznaczać co robią jakieś magiczne linie kodu (i tak, zdarzają się, choćby dlatego, że niektóre przeglądarki naprawdę wymagają magii do obejścia swoich bugów).