良い、悪い、醜いコメント

なぜコメントが必要なのか、コメントがなくても優れたコードを読み取ることができるのは事実であり、完璧主義によって開発が4倍遅くなるのは事実です。初心者、チーム、プロ向け。





良い、悪い、醜い、1966年
良い、悪い、醜い、1966年

直感的な知人

コメント付きは、他の関係と同様に、隠れた問題を引き起こします。スタックオーバーフローから、または私たちの創造性から、私たちは無意識のうちにコメントの方法を形成します。誰かが詳細すぎて、ユーモアのある人、そして誰かが一般的に「コメントなしで」書いていて、半年後、彼のコードがどのように機能するかを理解しようとさえしません。





追伸 あなたが本からコードのコメントについて学んだ人なら、サインを与えてください)あなたがすぐに答えを必要とするならば、彼らは最後にいます。





- - , "" , . , ... , , .





, . – , "" , .. , .





, , .





https://shoot-photo.com/desktop-wallpaper-zen.html
https://shoot-photo.com/desktop-wallpaper-zen.html

*. 950 , : " ". : " ", " , ".





, – . ? , , 20 . – -, , . , , " " .





20% , -, 5.





– , . , .





, 20% 80% – , , , . . , 100% "" / " " ( ). == .





, Win – , , , " " , , , . – .





– . , , .





*Code Complete, , 1993. " " " ". – , , "" , , .





.. , , – .





  1. "" .





    1. " " – /. . , (). : .





    2. – , , . , , .





    3. – , , , / , TODO (), FIX () .. , , . : , – .





  2. . 10 000 , 3 . – , "", . ( ), .





  3. – , . . .





  4. – , , .





  5. – . - . , , ", ". , , , ... , .





, !





.. ... .








All Articles