Citat:
|
Originalno napisao kaizen
Čovek to ne priča. Savet glasi: Write lots of comments. Dakle akcenat je na količini a ne na komentarima.
|
Očigledno nisi pročitao dobro. Njegov akcenat je tu na WHY a ne WHAT, i sa tim se slažem. Nije dovoljno napisati komentar "šta radiš", jer to svako ko ume da čita kod, ume i da rastumači. Slažem se sa tim da treba napisati "ZAŠTO" to radi.
Evo recimo primera. Za vikend sam radio jedan script za slanje SMS-a preko nekog austrijskog provajdera. I naravno, vidim u script (koji sam BTW ja radio pre 6 meseci) da stoji ovako:
PHP kôd:
$sms_text = utf8_decode($_POST['text']);
I sada, NIkome to nema logike, zašto bih slao sa UTF-8 strane tekst koji prvo utf8 dekodiram. Međutim stoji komentar pored da sam provajder konvertuje u UTF-8 (što gotovo niko ne radi već šalje "AS IS") i da jedino ako pošaljem dekodiran tekst, korisnik dobije ispravno nemačke karaktere ü i slično... Tako sam uštedeo vreme mozgajući zašto je to tako nelogično urađeno.
U tom slučaju ništa ne bi pomogao komentar "Ovde dekodiram utf8 string" već "Ovo mora tako zato što provajder ...".
Ja bih mogao i da se složim da ne treba pisati Lots of comments, jer čak i previše komentara smanjuje preglednost, ali to je u onom tekstu najmanji problem.
Citat:
|
Originalno napisao kaizen
"Top Ten of Programming Advice to NOT follow" je naslov. Po ovome "don't do" vidim da si pogrešno shvatio članak. Autor ne kaže da treba raditi suprotno od saveta koje kritikuje već da se treba rukovoditi drugim principima, i nudi neke (koje btw nije on smislio).
|
Ne razumem te, na osnovu čega si ti shvatio da sam ja to pogrešno shvatio? Ali nebitno...