Archiwa tagu: comments

Jak nie komentować kodu

Kilka tldr; Kod sam się komentuje (poprzez odpowiednie nazwy metod i klas, przestrzeganie SRP – klas metody będą niewielkie, korzystanie z ogólnie znanych wzorców) Jeśli powyższe nie wystarcza – ktoś kto nie potrafi zrobić powyższego, wyprodukuje komentarze jeszcze gorszej jakości … Czytaj dalej

Opublikowano Programowanie | Otagowano , , , | 4 komentarze

Comments good, bad and ugly

Komentarze w kodzie Najważniejszy drogowskaz, przy dodawaniu komentarzy w kodzie, to słowa, które przeczytałem kiedyś na jednym z polskich blogów: Komentarze są, żeby napisać dlaczego coś robię, a nie jak coś robię (nie pamiętam originału, ale tak to się w … Czytaj dalej

Opublikowano Programowanie | Otagowano ,