Navigacija
Lista poslednjih: 16, 32, 64, 128 poruka.

Jezik na kome pišete komentare i imena promjenljivih?

[es] :: Art of Programming :: Jezik na kome pišete komentare i imena promjenljivih?

Strane: < .. 1 2 3 4 5 6 7 8

[ Pregleda: 21771 | Odgovora: 141 ] > FB > Twit

Postavi temu Odgovori

Autor

Pretraga teme: Traži
Markiranje Štampanje RSS

ivan.mojsilovic
CEO @ Yanado.com
Novi Sad

Član broj: 277882
Poruke: 780
*.dynamic.sbb.rs.

Sajt: www.yanado.com


+1042 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?21.07.2012. u 13:01 - pre 142 meseci
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.
 
Odgovor na temu

Nedeljko
Nedeljko Stefanović

Član broj: 314
Poruke: 8632
*.3gnet.mts.telekom.rs.



+2789 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?21.07.2012. u 14:33 - pre 142 meseci
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.
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
 
Odgovor na temu

Nedeljko
Nedeljko Stefanović

Član broj: 314
Poruke: 8632
*.3gnet.mts.telekom.rs.



+2789 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?21.07.2012. u 14:49 - pre 142 meseci
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.
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
 
Odgovor na temu

aaaca
Aleksandar
Beograd

Član broj: 186587
Poruke: 203

Sajt: www.aca.rs


+11 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?21.07.2012. u 14:56 - pre 142 meseci
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.
Aca
Da li iko koristi Cold Fusion!? Ajde ljudi, ako čujete javite mi.
 
Odgovor na temu

Nedeljko
Nedeljko Stefanović

Član broj: 314
Poruke: 8632
*.3gnet.mts.telekom.rs.



+2789 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?21.07.2012. u 15:50 - pre 142 meseci
Ali previše u odnosu na alternativu od nekoliko desetina čovek-minuta.
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
 
Odgovor na temu

negyxo
Aleksandar Perkuchin

Član broj: 29751
Poruke: 898
*.dynamic.isp.telekom.rs.



+171 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?22.07.2012. u 06:48 - pre 142 meseci
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...
 
Odgovor na temu

mmix
Miljan Mitrović
Profesorkin muz
Passau, Deutschland

SuperModerator
Član broj: 17944
Poruke: 6041



+4631 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?22.07.2012. u 09:24 - pre 142 meseci
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
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ć
 
Odgovor na temu

ivan.mojsilovic
CEO @ Yanado.com
Novi Sad

Član broj: 277882
Poruke: 780
*.dynamic.sbb.rs.

Sajt: www.yanado.com


+1042 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?22.07.2012. u 10:26 - pre 142 meseci
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.
 
Odgovor na temu

negyxo
Aleksandar Perkuchin

Član broj: 29751
Poruke: 898
*.dynamic.isp.telekom.rs.



+171 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?22.07.2012. u 10:37 - pre 142 meseci
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 @!#$!@!@@#$%^#....
 
Odgovor na temu

Nedeljko
Nedeljko Stefanović

Član broj: 314
Poruke: 8632
*.3gnet.mts.telekom.rs.



+2789 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?22.07.2012. u 10:37 - pre 142 meseci
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.
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
 
Odgovor na temu

CiM0beTa

Član broj: 303979
Poruke: 194
193.107.4.*



+50 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?22.07.2012. u 10:41 - pre 142 meseci
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 :)
 
Odgovor na temu

ivan.mojsilovic
CEO @ Yanado.com
Novi Sad

Član broj: 277882
Poruke: 780
*.dynamic.sbb.rs.

Sajt: www.yanado.com


+1042 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?22.07.2012. u 10:55 - pre 142 meseci
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 :)
 
Odgovor na temu

flighter_022
L2 Applications Administrator
NS

Član broj: 18499
Poruke: 737
41.71.137.*

ICQ: 23089150


+232 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?23.07.2012. u 10:40 - pre 142 meseci
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
 
Odgovor na temu

ivan.mojsilovic
CEO @ Yanado.com
Novi Sad

Član broj: 277882
Poruke: 780
*.dynamic.sbb.rs.

Sajt: www.yanado.com


+1042 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?23.07.2012. u 10:52 - pre 142 meseci
Pa da, samo u savrsenom svetu gde programiraju savrsenni programeri. koji su btw tako rodjeni, moze fino da funkcionise bez komentara.
 
Odgovor na temu

Mihajlo Cvetanović
Beograd

Moderator
Član broj: 37636
Poruke: 1249



+96 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?23.07.2012. u 11:06 - pre 142 meseci
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.
 
Odgovor na temu

ivan.mojsilovic
CEO @ Yanado.com
Novi Sad

Član broj: 277882
Poruke: 780
*.dynamic.sbb.rs.

Sajt: www.yanado.com


+1042 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?23.07.2012. u 11:47 - pre 142 meseci
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.
 
Odgovor na temu

Nedeljko
Nedeljko Stefanović

Član broj: 314
Poruke: 8632
*.3gnet.mts.telekom.rs.



+2789 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?23.07.2012. u 11:57 - pre 142 meseci
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.
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
 
Odgovor na temu

mmix
Miljan Mitrović
Profesorkin muz
Passau, Deutschland

SuperModerator
Član broj: 17944
Poruke: 6041



+4631 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?23.07.2012. u 12:32 - pre 142 meseci
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).
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ć
 
Odgovor na temu

aaaca
Aleksandar
Beograd

Član broj: 186587
Poruke: 203

Sajt: www.aca.rs


+11 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?23.07.2012. u 12:37 - pre 142 meseci
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.
Aca
Da li iko koristi Cold Fusion!? Ajde ljudi, ako čujete javite mi.
 
Odgovor na temu

Nedeljko
Nedeljko Stefanović

Član broj: 314
Poruke: 8632
*.3gnet.mts.telekom.rs.



+2789 Profil

icon Re: Jezik na kome pišete komentare i imena promjenljivih?23.07.2012. u 12:58 - pre 142 meseci
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.
Nije bitno koji su zaključci izvučeni, već kako se do njih došlo.
 
Odgovor na temu

[es] :: Art of Programming :: Jezik na kome pišete komentare i imena promjenljivih?

Strane: < .. 1 2 3 4 5 6 7 8

[ Pregleda: 21771 | Odgovora: 141 ] > FB > Twit

Postavi temu Odgovori

Navigacija
Lista poslednjih: 16, 32, 64, 128 poruka.