• Najnowsze pytania
  • Bez odpowiedzi
  • Zadaj pytanie
  • Kategorie
  • Tagi
  • Zdobyte punkty
  • Ekipa ninja
  • IRC
  • FAQ
  • Regulamin
  • Książki warte uwagi

#dobrykod – Czy komentarze są złe?

VPS Starter Arubacloud
0 głosów
411 wizyt
pytanie zadane 28 maja 2016 w Nasze poradniki przez Marcel Radek Użytkownik (840 p.)

5 odpowiedzi

+2 głosów
odpowiedź 28 maja 2016 przez Comandeer Guru (599,730 p.)

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

+1 głos
odpowiedź 28 maja 2016 przez event15 Szeryf (93,790 p.)
Komentarze to temat rzeka, w sumie część rzeczy dobrze opisałeś.
0 głosów
odpowiedź 28 maja 2016 przez katolik6 Dyskutant (8,140 p.)
Myślę, że przed napisaniem jakiegokolwiek komentarza nalerzy sobie zadać pytanie: Czy on mi/koledze, który będzie go czytał pomoże.
0 głosów
odpowiedź 28 maja 2016 przez iWantCode Bywalec (2,170 p.)
Dobry komentarz nie jest zły.
0 głosów
odpowiedź 28 maja 2016 przez Damian11131 Stary wyjadacz (13,490 p.)
W "Czystym kodzie" autorstwa C. Martina bodajże jest napisane, że czytelny kod nie wymaga komentarzy.

Podobne pytania

+5 głosów
0 odpowiedzi 414 wizyt
pytanie zadane 13 maja 2016 w Nasze poradniki przez Marcel Radek Użytkownik (840 p.)
0 głosów
1 odpowiedź 497 wizyt
pytanie zadane 13 grudnia 2018 w JavaScript przez Venglas Obywatel (1,160 p.)
0 głosów
2 odpowiedzi 823 wizyt
pytanie zadane 12 grudnia 2018 w C i C++ przez Venglas Obywatel (1,160 p.)

92,452 zapytań

141,262 odpowiedzi

319,085 komentarzy

61,854 pasjonatów

Motyw:

Akcja Pajacyk

Pajacyk od wielu lat dożywia dzieci. Pomóż klikając w zielony brzuszek na stronie. Dziękujemy! ♡

Oto polecana książka warta uwagi.
Pełną listę książek znajdziesz tutaj.

Akademia Sekuraka

Akademia Sekuraka 2024 zapewnia dostęp do minimum 15 szkoleń online z bezpieczeństwa IT oraz dostęp także do materiałów z edycji Sekurak Academy z roku 2023!

Przy zakupie możecie skorzystać z kodu: pasja-akademia - użyjcie go w koszyku, a uzyskacie rabat -30% na bilety w wersji "Standard"! Więcej informacji na temat akademii 2024 znajdziecie tutaj. Dziękujemy ekipie Sekuraka za taką fajną zniżkę dla wszystkich Pasjonatów!

Akademia Sekuraka

Niedawno wystartował dodruk tej świetnej, rozchwytywanej książki (około 940 stron). Mamy dla Was kod: pasja (wpiszcie go w koszyku), dzięki któremu otrzymujemy 10% zniżki - dziękujemy zaprzyjaźnionej ekipie Sekuraka za taki bonus dla Pasjonatów! Książka to pierwszy tom z serii o ITsec, który łagodnie wprowadzi w świat bezpieczeństwa IT każdą osobę - warto, polecamy!

...