Komentowanie kodu jako nieporadność?

Rozpoczęty przez proce55or
6fac8df501a70372dd6458dd6ff8b1fb?s=128&d=mm

proce55or

W kursie HTML zaraz na początku, w dziale o komentarzach jest takie coś:

"W programowaniu komentarze są najczęściej używane, aby wyjaśnić pewien fragment kodu. Musisz mieć jednak świadomość, iż należy ich unikać. Obecność komentarzy zawsze sygnalizuje nieporadność programisty. Kod powinien być napisany tak, aby nie wymagał komentarzy, chociaż są również małe wyjątki od tej reguły."

Uczyłem się w kilku kursach, ale zawsze uczono mnie, że jest na odwrót, komentować trzeba, bo to, że kod może być zrozumiały dla mnie, nie znaczy, że będzie zrozumiały dla kogoś, kto być może będzie ten kod edytował w późniejszym czasie…

4eb8ab7c93bf67fb53cc5f6a78a9cd1c?s=128&d=mm

zawisza_zielony

Szkoły są dwie:

  1. nie komentuj bo to świadczy o braku profesjonalizmy oraz nierozumieniu napisanego przez siebie kodu,
  2. komentuj bo za kilka tygodni lub miesięcy nie będziesz wiedział do czego odnosi się ten kod.
    Wybór zależy od indywidualnych predyspozycji.
E1bc9a89969e416a98078cb2f15b0080?s=128&d=mm

thecieniu

To zależy też co się dzieje z tym kodem - sama jak już to pracuję na kodzie kupionym od kogoś, w którym po prostu wprowadzam poprawki i dostosowuje do własnych wymagań. Taki kod to produkt i komentarze dla mnie jako użytkownika to super sprawa, ponieważ usprawniają i przyspieszają pracę. Poradziłabym sobie bez tego, ale po prostu z komentarzem jest szybciej. Jeżeli to projekt który sprzedajesz albo przekazujesz dalej, to w niektórych miejscach warto dodać komentarze jako wyróżniki miejsc w których następna osoba ma coś zrobić.

F6953a9c43061cc7d82bcec2508f0e79?s=128&d=mm

adex

Ja raczej skłaniałbym się ku zdaniu, że jednak należy komentować. Być może nie należy przesadzać w przypadku małych projektów, lub w przypadku gdy kod nie wychodzi na zewnątrz, ale nie zgadzam się ze stwierdzeniem widocznym w kursie.

Zaloguj się, aby odpowiedzieć