#dobrykod – Czy komentarze są złe?

Ta kwestia od jakiegoś czasu zdaje się dzielić programistów niemalże tak mocno jak podział na zwolenników Javy i C# – czy trzeba komentować kod? ...

[mj89]

Komentarzy używam w 3 przypadkach:

1) Krótkie wyjaśnienie skomplikowanego algorytmu - bardziej matematyczne niuanse niż notatka jak działa CRUD w naszym serwisie.
2) Wyjaśnienie zastosowania hacku który bez komentarza jest nieoczywistą, wręcz głupią linijką kodu
3) TODO które robię na swoim branchu. Czyszczę wszystkie przed mergem funkcjonalności do głównej gałęzi czyli max po tygodniu.

I o ile nie robimy bibliotek/szablonów wykorzystywanych publicznie lub przez więcej niż 2 osoby w zespole, to w/w

[ProfesorJagoda]

Ja używam jedynie komentarz TODO i mam gotową listę zadań :)

[Gracz]

Czy komentarze sa zle? Odpowiedz: nie. Czy nalezy komentować kod: tak.
Dziękuję. Dobranoc.

[s.....3]

@Gracz: hahahah ( ͡° ͜ʖ ͡°)

[k.....n]

złe, pozdrawiam