#dobrykod – Czy komentarze są złe?

Question

A Wy co sądzicie o komentarzach?

http://roboblog.eu/2016/05/27/dobrykod-komentarze-sa-zle/

Answer 1

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).

Answer 2

Komentarze to temat rzeka, w sumie część rzeczy dobrze opisałeś.

Answer 3

Myślę, że przed napisaniem jakiegokolwiek komentarza nalerzy sobie zadać pytanie: Czy on mi/koledze, który będzie go czytał pomoże.

Answer 4

Dobry komentarz nie jest zły.

Answer 5

W "Czystym kodzie" autorstwa C. Martina bodajże jest napisane, że czytelny kod nie wymaga komentarzy.