[frezarkotokarka]

Pytanie do doświadczonych programistów. Czy do każdej napisanej funkcjonalności/kodu piszecie wyczerpujący komentarz? Czy może jeśli zmienne są dobrze nazwane to nie trzeba? #naukaprogramowania #programowanie

[Nadrill]

@frezarkotokarka: dobrze nazwane zmienne i testy sa wystarczajacym komentarzem. chyba ze jest to cos co opiera sie na jakims algorytmie, ktory trzeba dobrze wyjasnic.

[that_ugly_dude]

@frezarkotokarka: jeżeli definiujesz interfejs, to w niektórych miejsach za dobrą praktykę uznaje się komentarz a'la javadoc do każdej metody lub funkcji publicznej - ogólnie co robi, znaczenie paramsów, znaczenie wyjścia, wyjątki

[-PPP-]

@frezarkotokarka: Generalnie to dużo zależy od tego przy czym akurat pracujesz i jaki jest Twój stopień zaawansowania...

Jeśli jesteś początkujący to nawet nie czytaj dalej - pisz tyle komentarzy ile Ci się podoba. To jeszcze nie czas aby się tym przejmować, istnieje dla Ciebie teraz multum duuużo ważniejszych zagadnień do ogarnięcia.

Teraz gdy jesteś już na jako takim poziomie i zaczynasz czuć się pewnie albo nawet już pracujesz w branży to