Novo

Forum kao aplikacija na telefonu

Dodajte forum na početni ekran i koristite ga kao aplikaciju, sa menijem na dnu ekrana.

Jezik na kome pišete komentare i imena promjenljivih?

  • 141 odgovor
  • 33.998 pregleda

Najnovija ↓

Re: Jezik na kome pišete komentare i imena promjenljivih? 21.07.2012. u 14:01 · pre 173 meseca #81
Kad se vise izgubi vremena, kad se napise koometar kojem ne trab vise od minut-dva i koji se procita za 10 sekundi, ili da se bulji u unit testove, kapira kod itd?

Pogotovo ako ne poznajemo kontekst aplikacije ili njenog dela dovoljno dobro a sto je kod velikih projekata stalnost.
Potpis
www.yanado.com
www.startupscave.com
www.e-75.rs
www.twitter.com/mojsilo_
Re: Jezik na kome pišete komentare i imena promjenljivih? 21.07.2012. u 15:33 · pre 173 meseca #82
Niko da mi odgovori na ovo pitanje:
Citat:
Nedeljko: Skram kao lean metodologija razvoja odbacuje pisanje tehničke dokumentacije. Razmislite zašto.

Recimo da imam prokjekat od oko 10,000 funkcija. Ništa posebno, ništa nerealno. Da bih ga ja dokumentovao, ne treba uložiti par čovek-minuta, nego par čovek-meseci. E, sad, dolazi novi programer u firmu i nije mu jasno 50 funkcija, a dokumentacije nema. Šta onda? Pa, ništa, pitaće nekoga ko zna i on će mu to objasniti za sat vremena. Šta je racionalnije, uložiti par čovek-meseci ili jedan čovek-sat?

Lean metodologije razvoja zabranjuju da se radi bilo šta će naknadno biti neupotrebljeno. U prethodnom primeru neupotrebljeno je 99,5% dokumentacije. U scrum-u postoje pojmovi proizvoda (onoga što se radi) i korisnika proizvoda (onoga ko će to da koristi). Recimo, ako je proizvod alat za dalji proces proizvodnje, korisnik je radnik koji će da koristi taj alat u daljem procesu proizvodnje. U slučaju proizvoda za masovno tržište, korisnik je masa ljudi koja se anketira itd. Ono što nema korisnika ili ima "zamišljenog" ili "potencijalnog" korisnika se ne radi. Ko je korisnik dokumentacije? Pa, onaj ko se naknadno bude uključio u projekat. Dakle, radi se o "potencijalnom" korisniku. Mi ne znamo šta će od detalja njemu tačno da treba, tj. kojih 0,5% dokumentovati. Zato dokumentaciju ne treba ni raditi, već ga pustiti da sam dođe da pita ono što mu nije jasno. Takođe, dokumentacija koja je jednosmerna je po pravilu opširnija od "žive reči" koja je dvosmerna, gde se objašnjava samo ono što zaista nije jasno.

Da se popravim. Obično se zna kojih je 0,5% koda problematično i samo to treba dokumentovati da se ne bi objašnjavalo svaki put kada neko dođe.
Potpis
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
Sviđa mi se1
Re: Jezik na kome pišete komentare i imena promjenljivih? 21.07.2012. u 15:49 · pre 173 meseca #83
Citat:
negyxo: Cek, ko dokazuje da su unti testovi ispravni? :-)

Ništa nije savršeno, ali njih je pisao neko ko zna dotični modul, a koristi neko ko možda i ne zna.
Potpis
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
Re: Jezik na kome pišete komentare i imena promjenljivih? 21.07.2012. u 15:56 · pre 173 meseca #84
Citat:
Nedeljko: Niko da mi odgovori na ovo pitanje:

Recimo da imam prokjekat od oko 10,000 funkcija. Ništa posebno, ništa nerealno. Da bih ga ja dokumentovao, ne treba uložiti par čovek-minuta, nego par čovek-meseci. E, sad, dolazi novi programer u firmu i nije mu jasno 50 funkcija, a dokumentacije nema. Šta onda? Pa, ništa, pitaće nekoga ko zna i on će mu to objasniti za sat vremena. Šta je racionalnije, uložiti par čovek-meseci ili jedan čovek-sat?
......


Nekoliko čovek-meseci uloženih u pisanje dokumentacije, nije ništa u odnosu na nekoliko čovek-godina uloženih u pisanje dotičnih funkcija.
Potpis
Aca
Da li iko koristi Cold Fusion!? Ajde ljudi, ako čujete javite mi.
Re: Jezik na kome pišete komentare i imena promjenljivih? 22.07.2012. u 07:48 · pre 173 meseca #86
Citat:
Nedeljko: Ništa nije savršeno, ali njih je pisao neko ko zna dotični modul, a koristi neko ko možda i ne zna.


Ma znam Nedeljko, negde se mora povuci granica, ne moze se stalno preispitivati sve, zavrsili bi u mrtvoj petlji :-)

No ja i dalje mislim da su unit testovi previse hype-ovani. Po meni, static checking je majka, ako ti napises dovoljno informacija onda kompjuter moze da pise testove mesto tebe (OK ne sve, posto bi nesto zahtevalo priliko duboku hierarhiju definisnaja problema, odnosno vec se zalazi u domen AGI-a :-)). Primer automatskog testiranja je recimo PEX. Naravno, PEX ima samo smisla ako ti napises dovoljno informacija, kako bi on znao sta da trazi... ali eto, nesto mi se cini da MS ovo napusta, nekako sve je ostalo u experimentalnoj fazi. tj. ja sam bio iznenadjen da je prilicno mali broj ljudi upoznat sa tim, problem je sto ovakav nacin pisanja programa mu dodje kao nova paradigma, isto kao objektno orijentisano programiranje, zahteva drugi mentalni pristup.

Mislim da bi zlatna sredina bila kada bi se sve to integrisalo u neko novo okruzenje, programski jezik koji bi bio mnogo vise intuitivan...
Re: Jezik na kome pišete komentare i imena promjenljivih? 22.07.2012. u 10:24 · pre 173 meseca #87
Dobro, i ja resim cost benefit analizom da zatvorim to odeljenje i prebacim ceo dev u srbiju/kinu/avganistan i sad imam tonu scrum(tm) koda i zavisiim od lika kojeg planiram da otoustim da uradi knowedge transfer? Techdoc je keva, scrum je po mnogim pitanjima liabilty za firme
Potpis
Sloba je za 12 godina promenio antropološki kod srpskog naroda. On je od jednog
naroda koji je bio veseo, pomalo površan, od jednog naroda koji je bio znatiželjan, koji
je voleo da vidi, da putuje, da upozna,
od naroda koji je bio kosmopolitski napravio narod koji je namršten, mrzovoljan,
sumnjicav, zaplašen, narod koji se stalno nešto žali, kome je stalno neko kriv - Z.Đinđić
Re: Jezik na kome pišete komentare i imena promjenljivih? 22.07.2012. u 11:26 · pre 173 meseca #88
Nedeljko a ako nemam koga da pitam (sto umrli, sto otisli)? Projekat je live vec 10 godina a ja treba da resim problem a nema nkoga da se pita? I sto neko kaze nekoliko covek-meseci na projektu od nekoliko covek-godina nije apsolutno nista. Jos da ponovim na cemu se sve gubi vreme, komentari su u domenu statisticke greske.

Unit test - em ne kapira covek kontekst projekta ondah, em ne kapira kod najbolje i tu unit test da mu pojasni zasto je nesto kako jeste? Nema sile.
Potpis
www.yanado.com
www.startupscave.com
www.e-75.rs
www.twitter.com/mojsilo_
Re: Jezik na kome pišete komentare i imena promjenljivih? 22.07.2012. u 11:37 · pre 173 meseca #89
Komentare je najbolje pisati kada programer oseca potrebu za to. Znam da je ovo relativno, ali tako je bar kod mene. Najgluplje sto sam video je forsiranje komentara na svakoj funkciji, property-u, delegatu, eventu, sta god. Pa recimo dobijes company standard violation ako ne napises za property IsVisible komentar @!#$!@!@@#$%^#....
Re: Jezik na kome pišete komentare i imena promjenljivih? 22.07.2012. u 11:37 · pre 173 meseca #90
Neki to rešavaju tako što za svaku komponentu imaju najmanje dva čoveCa koja je znaju, pa kad jedan umre/ode, zaposli se nov kome onaj drugi prenese znanje.
Potpis
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
Re: Jezik na kome pišete komentare i imena promjenljivih? 22.07.2012. u 11:41 · pre 173 meseca #91
ne znam kako je po firmama. ali ja evo pisem komentare- pola srpski pola engleski. Jer mi engleski bas nije savrsen...a i neke stvari je nemoguce prevesti. Uvek me buni email, browser itd...prevoditi ili ne.. inace funkcije promenljive, imena fajlova, sve to na engleskom. A kad zavrsim sve to..recimo neki project uvek mi se javi želja da izbrišem sve komentare i što više zbijem kod, da bi bio brzi :)
Re: Jezik na kome pišete komentare i imena promjenljivih? 22.07.2012. u 11:55 · pre 173 meseca #92
Citat:
Nedeljko:
Neki to rešavaju tako što za svaku komponentu imaju najmanje dva čoveCa koja je znaju, pa kad jedan umre/ode, zaposli se nov kome onaj drugi prenese znanje.


Kazem ja, savrsen je to svet :)
Potpis
www.yanado.com
www.startupscave.com
www.e-75.rs
www.twitter.com/mojsilo_
Re: Jezik na kome pišete komentare i imena promjenljivih? 23.07.2012. u 11:40 · pre 173 meseca #93
U korist detaljnog pisanja komentara je i sledece:

Recimo, dodjete u situaciju da ste pre na primer 7-8 godina nekom uradili softver za neku odredjenu namenu. Sors jer kod vas, ali posto ste to radili specijalno za tog klijenta, vise sors niste dirali do sada. I sada treba napraviti neke promene na softveru, razlog i priroda promena su nebitni, ali je bitno da treba da prodjete kroz mnogo linija koda, prisetite se sta ste i kako, i zasto, pisali pre 7-8 godina? Bez komentara trebace vam barem nekoliko dana da vidite gde i sta treba uraditi. Sa komentarima, mnogo manje.

A zamislite onda recimo da je klijent zaposlio (stalno ili privremeno, nebitno) nekog ko moze da uradi izmene, ali nema sors. Naravno, mozete dati sors takav kakav je, bez komentara, ili sa komentarima na jeziku koji taj programer ne zna. Njemu ce trebati izuzetno mnogo vremena da se snadje.

Zato, standard treba da postoji, i za to gde se i kako pisu komentari, i za to na kom jeziku.

Ja licno radim na softveru, i kako koji modul je spreman, uradim komentare. Cesto se desi da tokom pisanja komentara vidim neki manji problem, sansu za ispravke ili unapredjenja, i svi su zadovoljni :D
Re: Jezik na kome pišete komentare i imena promjenljivih? 23.07.2012. u 12:06 · pre 173 meseca #95
Pisanje komentara doprinosi boljem kodu. Umesto da se sramotim komentarom tipa "ovo je ovako, jer me je mrzelo onako" radije ću da prepravim kod tako da više nema potrebe za takvim komentarom. Za ostale komentare moram da imam u vidu šta sve treba da zna prosečni programer, kao i sebe kad pozaboravljam detalje posle pola godine. Ono što prevazilazi bilo jednog bilo drugog treba da ide u komentar. Na žalost, nikako nemam volje za one glavne komentare, zaglavlja funkcija. To mi je slabost.
Re: Jezik na kome pišete komentare i imena promjenljivih? 23.07.2012. u 12:47 · pre 173 meseca #96
Kad se poznaje kontekst aplikacije onda je lakse snaci se u kodu i bez komentara. Ali kad se ne zna kontekst, ili se slabo poznaje (tipa potrebno je bar 12 meseci da se sve pohvata) onda su komentari spas.
Potpis
www.yanado.com
www.startupscave.com
www.e-75.rs
www.twitter.com/mojsilo_
Re: Jezik na kome pišete komentare i imena promjenljivih? 23.07.2012. u 12:57 · pre 173 meseca #97
Citat:
flighter_022: U korist detaljnog pisanja komentara je i sledece:

Recimo, dodjete u situaciju da ste pre na primer 7-8 godina nekom uradili softver za neku odredjenu namenu. Sors jer kod vas, ali posto ste to radili specijalno za tog klijenta, vise sors niste dirali do sada. I sada treba napraviti neke promene na softveru, razlog i priroda promena su nebitni, ali je bitno da treba da prodjete kroz mnogo linija koda, prisetite se sta ste i kako, i zasto, pisali pre 7-8 godina? Bez komentara trebace vam barem nekoliko dana da vidite gde i sta treba uraditi. Sa komentarima, mnogo manje.

E, sad lepo pomnoži tu vremensku uštedu sa verovatnoćom da ćeš to ikada raditi, pa uporedi sa vremenom potrebnim za pisanje svih tih komentara.
Citat:
ivan.mojsilovic: Pa da, samo u savrsenom svetu gde programiraju savrsenni programeri. koji su btw tako rodjeni, moze fino da funkcionise bez komentara.

Nešto si pobrkao. Kod će raditi na potpuno isti način i ako se izbace svi komentari iz njega.

Na kraju krajeva, pronicanje u kod koji je neko drugi pisao je opšti programerski skil. To se jednostavno podrazumeva. Zamisli da ti se pokvari frižider, pozoveš majstora a on se žali na to da nemaš tehničku dokumentaciju frižidera. To jednostavno nije masjtor. Takvom bih se zahvalio i pozvao drugog.
Potpis
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
Re: Jezik na kome pišete komentare i imena promjenljivih? 23.07.2012. u 13:32 · pre 173 meseca #98
Babe i zabe, nedeljko.

Ako vec hoces realnije poredjenje to bi bilo da firma A prodaje firmi B dizajn frizidera i kaze "ma snaci cete se vi samo pratite crveni kabl" i kad traze techdoc ti im kazes "kakvi ste vi to inzenjeri" :)

Sansa da ces raditi follow up nekog softverskog proizvoda je ogromna, ako ne pre onda u trenutku promene platformi, ako ne ti onda neko ko to bude gledao kroz 10 ili 20 godina. Ja stvarno ne mogu da verujem da se kao relana zastupa teza da je dokumentacija visak (to ukljucuje i komentare, i u novije vreme doc comments tagove).
Potpis
Sloba je za 12 godina promenio antropološki kod srpskog naroda. On je od jednog
naroda koji je bio veseo, pomalo površan, od jednog naroda koji je bio znatiželjan, koji
je voleo da vidi, da putuje, da upozna,
od naroda koji je bio kosmopolitski napravio narod koji je namršten, mrzovoljan,
sumnjicav, zaplašen, narod koji se stalno nešto žali, kome je stalno neko kriv - Z.Đinđić
Re: Jezik na kome pišete komentare i imena promjenljivih? 23.07.2012. u 13:37 · pre 173 meseca #99
Frižider baš i nije najbolji primer jer ima pet sastavnih delova.

Stare televizore nije bilo šanse popraviti bez detaljne elektronske šeme istog. Ovi novi televizori ne mogu da se poprave bez specijalnog uređaja koji će "majstoru" reći gde je kvar.
Potpis
Aca
Da li iko koristi Cold Fusion!? Ajde ljudi, ako čujete javite mi.
Re: Jezik na kome pišete komentare i imena promjenljivih? 23.07.2012. u 13:58 · pre 173 meseca #100
Programski jezik je već jezik, tako da je dokumentovanje ništa drugo do pisanje iste stvari na dva jezika.

Zašto po istom rezonu ne bismo pisali istu stvar na više programskih + više prirodnih jezika?

Zlatna sredina između dokumentovanja svega i nedokumentovanja ničega je dokumentovanje onih 0.5% koda koji zaslužuju dokumentaciju.
Potpis
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
Sviđa mi se1
Odgovori
Prijavite se da biste odgovorili u ovoj temi.PrijavaRegistracija

Premeštanje teme