470
pakeitimų
Kodo komentavimas: Skirtumas tarp puslapio versijų
nėra keitimo aprašymo
(Naujas puslapis: '''Kodo komentavimas''' - ir '''programavimo komentarai''' - tai tas dalykas, kurio daryti nekenčia jokie programuotojai, nes tingisi, ir savaime aišku ir taip toliau. Rezultate paprastai gaunamas kodas, kuris niekaip negali būti nei pataisytas, nei pagerintas, nei pakeistas, nes niekas nesupranta, kas ten jame vyksta. Nors kažkam, kas tą kodą rašė, tuo metu atrodė, kad viskas ir taip savaime aišku. Blogai komentuotas kodas yra viena iš esminių priežasči...) |
|||
| 1 eilutė: | 1 eilutė: | ||
'''Kodo komentavimas''' - ir '''programavimo komentarai''' - tai tas dalykas, kurio daryti nekenčia jokie [[programuotojai]], nes tingisi, ir savaime aišku ir taip toliau. Rezultate paprastai gaunamas kodas, kuris niekaip negali būti nei pataisytas, nei pagerintas, nei pakeistas, nes niekas nesupranta, kas ten jame vyksta. Nors kažkam, kas tą kodą rašė, tuo metu atrodė, kad viskas ir taip savaime aišku. | '''Kodo komentavimas''' - ir '''programavimo komentarai''' - tai tas dalykas, kurio daryti nekenčia jokie [[programuotojai]], nes tingisi, ir savaime aišku ir taip toliau. Rezultate paprastai gaunamas kodas, kuris niekaip negali būti nei pataisytas, nei pagerintas, nei pakeistas, nes niekas nesupranta, kas ten jame vyksta. Nors kažkam, kas tą kodą rašė, tuo metu atrodė, kad viskas ir taip savaime aišku. | ||
Blogai komentuotas kodas yra viena iš esminių priežasčių, dėl kurių veikia [[ | Blogai komentuotas kodas yra viena iš esminių priežasčių, dėl kurių veikia [[Kernighano dėsnis]], o taip pat viena iš esminių priežasčių [[kodo refaktoringas|kodo refaktoringui]]. | ||
Nemaža dalimi atvejų, kai vykdomas kodo refaktoringas, pakanka tą kodą tiesiog gerai sukomentuoti. Deja, [[paradoksas]] yra toks, kad kai kodas būna visiškai nekomentuotas, tai vykdant jo refaktoringą, pagal tą patį [[Kernighano dėsnis|Kernighano dėsnį]] būna bent du kartus paprasčiau kodą perrašyti iš naujo, negu išsiaiškinti, ką jis daro ir tada patvarkyti. Todėl refaktorinimo metu programuotojai perrašo kodą iš naujo ir, ''surprise surprise'', jo vėl nesukomentuoja. Ir tada rezultatas tas pats - kodas lieka nesuprantamas ir po kiek laiko vėl refaktorinamas vien dėl to, kad yra nesuprantamas, ir vėl neparašant komentarų. Tokiu būdu vyksta amžinas kodo refaktoringas vien dėl nekomentavimo. | Nemaža dalimi atvejų, kai vykdomas kodo refaktoringas, pakanka tą kodą tiesiog gerai sukomentuoti. Deja, [[paradoksas]] yra toks, kad kai kodas būna visiškai nekomentuotas, tai vykdant jo refaktoringą, pagal tą patį [[Kernighano dėsnis|Kernighano dėsnį]] būna bent du kartus paprasčiau kodą perrašyti iš naujo, negu išsiaiškinti, ką jis daro ir tada patvarkyti. Todėl refaktorinimo metu programuotojai perrašo kodą iš naujo ir, ''surprise surprise'', jo vėl nesukomentuoja. Ir tada rezultatas tas pats - kodas lieka nesuprantamas ir po kiek laiko vėl refaktorinamas vien dėl to, kad yra nesuprantamas, ir vėl neparašant komentarų. Tokiu būdu vyksta amžinas kodo refaktoringas vien dėl nekomentavimo. | ||