20 yıllık bir yazılım mühendisi olarak, çoğunlukla güvenlikle ilgili konularda (SF-PD) çalışıyor, patronunuzun sizin örneğiniz olmak istediğiniz kişi olamayacağını söylemek zorundayım. Yorumların olmaması, işi düzgün bir şekilde yapmayı asla öğrenemeyen, kendi kendine öğretilen amatör bir kodlayıcı ya da deneyimsiz bir mühendisin bir işaretidir. Ya da belki de sadece zamanı olmayan bir mühendis - son tarihler ve uygunluk kodunuza korkunç şeyler yapabilir! ;) Kesinlikle her yetkili yazılım mühendisi için kesinlikle bir anti-patern.
Patronun çok iyi bir kodlayıcı olabilir, ama iyi bir yazılım mühendisi değil gibi görünüyor. Bir mühendis, diğer insanların zaten yakaladıkları tuzaklardan kaçınmak için toplu grup deneyimini kullanır. Etkili yorumlama, yazılım için bu toplu grup deneyiminin bir parçasıdır, stres analizi ile aynı şekilde makine mühendisliği için de ortak grup deneyiminin bir parçasıdır. Etkili yorumlama olarak sayılan şey daha akışkandır ve kesinlikle deneyimden edindiğiniz bir şeydir.
En temel şey, yorumların bir kod satırının ne yaptığını söylememesi gerektiğidir. Bir fonksiyonun ne yaptığını söyleyen yorumların (özellikle C #) gereksiz olduğu zamanlar vardır. Aşırı yorum yapmak da etkisiz olabilir (ve deneyim eksikliğinin bir göstergesidir) çünkü cürufta önemli maddeleri bulamazsınız. Bir acemi olarak, hala kodun "ne" olduğunu bulmak için çalışıyor olabilirsiniz ve bunun için sadece ne yaptığını okumanız ve anlamanız gerekiyor.
Ancak yorumlar için önemli olan şey, NEDEN bir kod satırı veya fonksiyonun yaptığı şeyi yaptığını, bunun açık olmadığı durumlarda söylemesidir . Y modülünden önce X modülünü kurmanız mı gerekiyor? Bir dosyanın zaten açık olup olmadığını görmek için bir dönüş kodunu kontrol etmek önemli mi, yoksa bu başka bir yerde kontrol edildiğinden, dönüş kodunu bilinçli olarak görmezden mi geliyoruz? Kodun "nedeni", deneyime bakılmaksızın herkesle alakalı olacaktır - ve belirli bir şeyi yapmanın iyi bir nedenini unuttuğu zaman 6 ay içinde de onunla ilgili olacaktır. Yorum yapmak sadece diğer insanlar için değil, gelecekte de size yardımcı olmak içindir.
Patronunuzu sinirlendirmekten kaçınmak istiyorsanız, akıllı sorular sorun. “Neden” hakkında soru sormaya odaklanın ve “ne” yu kendiniz bulmaya çalışın (gerçekten belirsiz olmadığı sürece). Hiçbir iyi patron, R-ing TFM'den bulabileceğiniz türden şeyler değilse, sorular sorulmasının sakıncası olmaz. Ve iyi bir mühendis, başka bir mühendisin hayatını önemli ölçüde kolaylaştıracak bir şey yapmamın istendiğini aldırmayacaktır, onlara düşük maliyetle. (Sadece tüm kod temeli hakkındaki yorumları doldurmasını istemeyin!;)