Mengapa kita membutuhkan komentar, apakah benar bahwa kode yang baik dapat dibaca tanpanya, dan bagaimana perfeksionisme memperlambat pengembangan sebanyak 4 kali. Untuk pemula, tim, profesional.
Kenalan yang intuitif
dengan komentar, seperti dalam hubungan apa pun, menciptakan masalah tersembunyi. Dari stackoverflow atau dari kreativitas kita, tanpa disadari kita membentuk cara berkomentar. Seseorang terlalu rinci, seseorang dengan humor, dan seseorang umumnya menulis "tanpa komentar" dan setelah setengah tahun bahkan tidak mencoba untuk memahami cara kerja kodenya.
P.S. Jika Anda adalah orang yang belajar tentang komentar dalam kode dari buku, beri tanda) Jika Anda membutuhkan jawaban segera, mereka ada di akhir.
- - , "" , . , ... , , .
, . – , "" , .. , .
, , .
–
*. 950 , : " ". : " ", " , ".
, – . ? , , 20 . – -, , . , , " " .
20% , -, 5.
– , . , .
, 20% 80% – , , , . . , 100% "" / " " ( ). == .
, Win – , , , " " , , , . – .
– . , , .
*Code Complete, , 1993. " " " ". – , , "" , , .
.. , , – .
"" .
" " – /. . , (). : .
– , , . , , .
– , , , / , TODO (), FIX () .. , , . : , – .
. 10 000 , 3 . – , "", . ( ), .
– , . . .
– , , .
– . - . , , ", ". , , , ... , .
, !
.. ... .