Prijava

Moja eKapija

Kontakt
NavMenu
Agro Energija Industrija Građevina Saobraćaj Finansije IT/Telekomunikacije Turizam, sport, kultura Zdravstvo Lifestyle Poslije posla
Početna Vijesti

Često pitanje među programerima - Da li je komentarisanje koda uvijek korisno i potrebno?

Izvor: Startit Petak, 24.05.2019. 09:26
Komentari
Podeli
(Foto: ronstik/shutterstock.com)
Treba da komentarišite svoj kod. Oko ove rečenice lako se sukobe mišljenja. Možda zato što je kliše. A kao u svakom klišeu, u njoj ima ponešto istine. Odnosno, istina je poslovično negdje između, što potvrđuju i iskustva onih koji komentarisanje koda primjenjuju u praksi.

Bez obzira na ova dva sukobljena mišljenja, iskusniji programeri uglavnom komentarišu ono što pišu, ali ne u svim situacijama. Kako kažu, potreba za time se uglavnom javlja onda kada su u pitanju kompleksni dijelovi koda.

- Trudim se da iskomentarišem sav kod prilikom čijeg pisanja sam morao da "razmislim"/isplaniram/raspišem/analiziram. Mjera u kojoj se to radi zavisi od projekta/taska/dijela sistema - kaže softver developer Vedran Mimić.

Slično je i sa Srđanom Brkićem, koji je takođe softver developer, i koji kaže da propratnu dokumentaciju piše na vrhu metoda.

- U drugim slučajevima samo kada logika nalaže (kada kod postane dovoljno kompleksan). Isto savjetujem početnicima i smatram da ne treba olako da se prepuste pisanju komentara, kod treba da bude dovoljno jasan i bez njih - kaže Brkić.

Sebastijan Vilhamer, programer u gejming industriji, često komentariše svoj kod, a početnicima jednako savjetuje da sačekaju sa pisanjem komentara.

- Što se početnika tiče, mislim da je pred njima dug put programiranja prije nego što dođe vrijeme da brinu o pisanju komentara. Za njih je važnije da pišu kod, da ga prepravljaju, brišu i ponovo pišu. Jer, svakako, većina početničkog koda bude odbačena. Kada komentarišeš ti zastaješ, razmišljaš, pokušavaš da dobiješ neku vrijednost, a to ne možeš pre nego što si napisao određenu količinu koda - poručio je Vilhamer.

Miloš Žarković, inženjer informacionih tehnologija rijetko komentariše svoj kod. Njegov stav se donekle razlilazi s ostalima. On se generalno protivi komentarisanju, jer je mišljenja da ono čini kod nejasnim.

- Smatram da količina komentara ne utiče na kvalitet koda, ali velika količina komentara na žalost u većini slučajeva ukazuje na to da kod nije dovoljno jasan, a samim tim ni kvalitetan. Moram da se ogradim, ovdje prije svega mislim na moderne high-level jezike. Početnicima bih savjetovao da probaju da refaktorišu svoj kod, a da komentare koriste kao posljednju opciju. Vjerujem da dobrom organizacijom i imenovanjem klasa, metoda i varijabli svaki kod može da postanje čitljiv i razumljiv - kaže Žarković.

Upravo je zahtjev da kod bude čitljiv i razumljiv jedna od okosnica kada govorimo o tome da li ga treba komentarisati. Zato je uobičajna praksa da kada želiš da pojasniš kod prvo pokušaš da ga napišeš na jednostavniji način, pa tek onda komentarišeš.

Srđan iz Eryce-a navodi da: "Komentar treba da kaže zašto je nešto urađeno, a kod — kako."

S druge strane, pojedini developeri smatraju da nema smisla pisati komentare u kojima se ponavlja šta kod radi ili se služiti komentarisanjem kako bi kod učinili jasnijim. U tom duhu i Srđan napominje da nema smisla pisati očigledne komentare i samo "prljati" kod, a Miloš navodi konkretnu situaciju u kojoj ne bi pisao komentare:

- Na primjer, kada imamo neku veliku metodu koja radi puno stvari, neko bi došao u iskušenje da stavi komentar iznad svakog koraka kako bi objasnio šta taj dio koda radi. U ovom slučaju ponovo preporučujem refaktorizaciju (razdvajanje cjelina u manje metode sa smislenim imenima) - kaže on.

Naravno, osim objašnjavanja komplikovanih i osjetljivih linija koda ili nekoliko linija koda (za one koji nisu autori ili za sebe), programeri u kod unose i komentare koji im služe kao bilješke da npr. rad nije završen. Međutim, po Sebastijanovom mišljenju to je drugačija vrsta problema, jer zahtjeva od programera da se sjeti i vrati na te komentare.

- Ako je kod čist, komentari nisu potrebni. Problem je što ne može sav kod da bude takav. Takođe, jedan od problema je u tome što kada jednom napišete komentar i kasnije mu se vratite obično će zastariti, jer se kod na koji se odnosi promjenio. Imaćete gomilu komentara koji više ništa ne znače, ili više nemaju smisla kao što su imali u trenutku kada ste ih pisali - kaže Sebastijan.
Tagovi:
Vedran Mimić
Srđan Brkić
Sebastijan Vilhamer
Miloš Žarković
developeri
pisanje koda
kodiranje
programeri
komentarisanje kodova
Komentari
Vaš komentar

Top priče

18.04.2024.  |  Građevina

Uskoro tender za rekonstrukciju zgrade Soda So u Tuzli, radovi će koštati više od 10 mil KM

Uručivanjem Glavnog projekta rekonstrukcije, dogradnje i nadogradnje zgrade Vlade Tuzlanskog kantona u Tuzli završena je još jedna od faza pripreme za obnovu i rekonstrukciju objekta poznatog kao zgrada "Soda-So". U narednom periodu preostaje raspisivanje tendera za izbor izvođača radova i konačno početak rekonstrukcije, saopštila je Vlada TK. Ministrica prostornog uređenja i zaštite okolice Anela Ajšić je izrazila svoje

19.04.2024.  |  Građevina, Saobraćaj, Turizam, sport, kultura

Ovako će izgledati jedna od kula u budućem kompleksu autobuske i željezničke stanice u beogradskom bloku 42 - M2 će imati 29 spratova, 390 stanova, bazen... (FOTO)

19.04.2024.  |  Građevina, Saobraćaj, Turizam, sport, kultura

18.04.2024.  |  Industrija, Saobraćaj

Za razvoj industrije u RS do 2026. više od 350 mil KM - Skoro polovina novca biće obezbijeđena iz budžeta

18.04.2024.  |  Industrija, Saobraćaj

19.04.2024.  |  Građevina, Saobraćaj, Turizam, sport, kultura

Izabrano pobjedničko rješenje za buduće zdanje Prirodnjačkog muzeja i Park prijateljstva u Beogradu - Pješački most do Velikog ratnog ostrva (FOTO)

19.04.2024.  |  Građevina, Saobraćaj, Turizam, sport, kultura

18.04.2024.  |  Finansije

Vlada RS usvojila izmjene Zakona o deviznom poslovanju - Dozvole za mjenjačke poslove izdavaće Agencija za bankarstvo

18.04.2024.  |  Finansije

19.04.2024.  |  Vijesti

Mali: Sljedeće godine investicioni rejting za Srbiju

19.04.2024.  |  Vijesti

18.04.2024.  |  Finansije

Konkurs za projekte iz zaštite okoliša u vrijednosti od 16,5 mil KM - Najviše novca za zaštitu voda, uklanjanje deponija, reciklažu i energijsku efikasnost

18.04.2024.  |  Finansije

eKapija+

Vidi sve

19.04.2024.  |  Vijesti

Novi direktor na čelu Federalne uprave civilne zaštite

19.04.2024.  |  Vijesti

19.04.2024.  |  Građevina, Finansije, IT, Telekomunikacije

Od sada račun za porez na nepokretnosti stiže na mejl - PURS aktivirala novu elektronsku uslugu eSaglasnost

19.04.2024.  |  Građevina, Finansije, IT, Telekomunikacije

19.04.2024.  |  Građevina, Finansije, Turizam, sport, kultura

Tender za nastavak radova na kulturno-sportskom domu u mjestu Jare - 240.000 KM za četvrtu fazu izgradnje

19.04.2024.  |  Građevina, Finansije, Turizam, sport, kultura

19.04.2024.  |  Agro

Kako se upisati u Registar poljoprivrednih gazdinstava u FBiH

19.04.2024.  |  Agro

17.04.2024.  |  Agro, Finansije, IT, Telekomunikacije

Danju razvija baze podataka, a noću kulinarske klipove - Kako je magistar kompjuterskih nauka Neno Cooks od kuvanja napravio biznis (VIDEO)

17.04.2024.  |  Agro, Finansije, IT, Telekomunikacije

18.04.2024.  |  Vijesti

Raspisan poziv za dodjelu finansijske podrške putem Inovacionih vaučera Zapadnog Balkana

18.04.2024.  |  Vijesti

18.04.2024.  |  Građevina

U Trnovu uklanjaju štetne azbestne cijevi - Potpisan ugovor o rekonstrukciji vodovoda

18.04.2024.  |  Građevina

18.04.2024.  |  Agro, Industrija

U toku poziv za sufinansiranje zapošljavanja pripravnika u sektoru poljoprivrede u FBiH

18.04.2024.  |  Agro, Industrija

Izdvajamo još...

Infrastruktura
Banjaluka sa milion maraka obnavlja dio Ulice Kralja Aleksandra Karađorđevića
Dodik: Do kraja godine građevinska dozvola za izgradnju aerodroma u Trebinju
Trebinje uskoro potpisuje ugovor o obilaznici vrijedan 5 mil KM - Nastavljaju se radovi na putu Žegulja-Stolac
Počeli pripremni radovi za izgradnju pristupnog puta za most u Česmi
Poslovni savjeti
Stručnjak tvrdi: Ovih pet pitanja morate postaviti poslodavcu na razgovoru za posao!
Šest stvari koje trebate znati prije apliciranja za EU fondove
Kako zamoliti menadžera da vam bude mentor?
Generacija Z je frustrirana uprkos tome što je naslijedila zlatno tržište rada
U šta ulagati?
Cijene povrća u porastu - Kupovati ili saditi svoju baštu?
Izdanci hmelja prodaju se po cijeni od 1.000 EUR za kilogram
Sibirski limun uspjeva i našim prostorima - Kako se uzgaja?
Ove biljke su dobre za zdravlje, ali i za paorsku zaradu
Finansiranje
EU garancije će osigurati oko 102 mil EUR za mala i srednja preduzeća u BiH
Razvojna banka FBiH i Raiffeisen Leasing sklopili ugovor za podršku malim i srednjim preduzećima
Objavljen poziv u RS za ovogodišnje kapitalne investicije u poljoprivredi
Sklopljen ugovor vrijedan 5 mil EUR za podršku malim i srednjim preduzećima

Rubrike za dalje čitanje

U šta ulagati
Startup
Infrastruktura
Cirkularna ekonomija
Retrospektiva investicija
Intervjui
Filantropi
Poslovni savjeti
Poslovno okruženje
Finansiranje
Ko je ko
Novi propisi
Potpuna informacija je dostupna samo komercijalnim korisnicima-pretplatnicima i neophodno je da se ulogujete.

Zaboravili ste šifru? Kliknite OVDJE

Za besplatno probno korišćenje, kliknite OVDJE

Pratite na našem portalu vijesti, tendere, grantove, pravnu regulativu i izvještaje.
Registracija na eKapiji vam omogućava pristup potpunim informacijama i dnevnom biltenu
Naš dnevni ekonomski bilten će stizati na vašu mejl adresu krajem svakog radnog dana. Bilteni su personalizovani prema interesovanjima svakog korisnika zasebno, uz konsultacije sa našim ekspertima.