Czemu nie pisać komentarzy…
Czasami, kiedy mówimy o jakości kodu, to pojawia się stwierdzenie „nasz kod jest kiepski, bo nie ma w nim komentarzy”. Powstaje taka intuicyjna równoważność: „dużo komentarzy – dobry kod, brak komentarzy – zły kod”. Ba, idąc tą drogą można nawet wprowadzić metrykę, określającą stosunek liczby komentarzy do liczby linii kodu i zmuszać programistów do osiągnięcia jakiejś magicznej jej wartości. Tylko po co? Czy zawsze komentarze ułatwiają nam analizę kodu? Czy istnieją komentarze, które przeszkadzają zamiast pomagać?
Chciałbym pokazać kilka rodzajów komentarzy, które są według mnie złe – czy to ze względu na ich nieprzydatność, źródło pochodzenia czy po prostu „paskudność”.Dowiedz się więcej »Czemu nie pisać komentarzy…