man pieredze raada ka visi kas raxta C++ juutaas baigie \m/ un raxta taadas konstrukcijas, ka peec tam vari godiigi noshauties!
taapat programmeetaajs nekad nespees uzraxtiit taadu kodu bez komentiem lai to saprastu citi programmeetaaji... a ja vot komentaaru uzraxta normaalaa valodaa, tad ir ceriiba ka citi to sapratiis! iipashi ja tas ir ieksh c++ kur katram ir savs "stils" un tad ej un saproti kas kur ar ko ir domaac!
piekriitu ka labaak raxtiit primitiivi bet skaidri nevis izmantojot superpuper konstrukcijas ar kuraam jaa var uzraxtiit baigo algoritmu 1aa rindinjaa, bet kuru arii pac nesapratiisi peec naakamaas piipauzes!
cienu komentaarus kas apskaidor input un output parametrus pirms funkcijaam un nevis formaa
// sourcePath - path to the source
bet krietni informatiivaakus
just my 2 cents
Lūdzu piemēru "taapat programmeetaajs nekad nespees uzraxtiit taadu kodu bez komentiem lai to saprastu citi programmeetaaji... ", kur blakus ir labs komentārs.
| From: | ![[info]](http://klab.lv/img/userinfo.gif) grrr |
|---|
| Date: | January 19th, 2004 - 10:34 am |
|---|
| | | (Link) |
|
tad komentus vajag vai nē? :D
jebkura funkcija kuras inputs ir sarezhgjiita predefineeta struktuura, kas var mainiities atshkjriiibaa no kontexta...
tb viena un taa pati struktuura (teixim FDO koks)... it kaa var meegjinaat un skatitiies funkcijaa kuraa vietaa kursh parametrs nodefineejas, bet ja pirms funkcijas ir normaalaa valodaa uzmests shii koka sagaidaamaa struktuura, tad nav jaaburaas cauri funkcijas baigaakajiem vipendrjozhiem lai saprastu kas notiek... kaa arii atrast intereseejosho koka zara apstraadi tad var daudz vieglaak!
kaut kaads tur
doSomething(param1, param2) kur param ir primitiivi, to jau toch nav jeega komenteet... a vot neprimitiivu struktuuru gadiijumaa - nefiga! ij ne vienmeer tu vari sho struktuuru kaa objektu defineet... iipashi ja struktuura pati ir dinamiska!
Es domāju konkrētu koda piemēru. :)
Labs kods + labi komentāri, ko nevar saprast bez tiem.
