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…
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ć.
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ć
Korzystając z Kodologii, przyjmujesz do wiadomości, że rozwijamy platformę wykorzystując cookies i pokrewne technologie. Dowiedz się więcejSchowaj