Sebagai seorang insinyur perangkat lunak yang telah berdiri selama 20 tahun, kebanyakan bekerja pada hal-hal yang berhubungan dengan keselamatan (SF-PD), saya harus mengatakan bahwa atasan Anda mungkin bukan orang yang Anda inginkan sebagai teladan Anda. Kurangnya komentar adalah pertanda baik seorang programmer amatir otodidak yang tidak pernah belajar bagaimana melakukan pekerjaan dengan baik, atau insinyur yang tidak berpengalaman. Atau mungkin seorang insinyur yang tidak punya waktu - tenggat waktu dan kebijaksanaan dapat melakukan hal-hal mengerikan pada kode Anda! ;) Ini jelas merupakan anti-pola untuk setiap insinyur perangkat lunak yang kompeten.
Bos Anda mungkin pembuat kode yang sangat bagus, tetapi sepertinya ia bukan insinyur perangkat lunak yang baik. Seorang insinyur menggunakan pengalaman kelompok kolektif untuk menghindari jebakan yang telah ditangkap orang lain. Komentar yang efektif adalah bagian dari pengalaman kelompok kolektif untuk perangkat lunak, dengan cara yang sama seperti analisis stres adalah bagian dari pengalaman kelompok kolektif untuk teknik mesin. Apa yang dianggap komentar efektif lebih lancar, dan itu pasti sesuatu yang Anda dapatkan dari pengalaman.
Yang paling mendasar adalah bahwa komentar tidak boleh mengatakan apa yang dilakukan oleh baris kode. Ada saat-saat ketika komentar untuk mengatakan apa fungsi tidak terlalu berlebihan (terutama di C #). Mengomentari berlebihan bisa sama tidak efektifnya (dan menunjukkan kurangnya pengalaman) karena Anda tidak dapat menemukan hal-hal penting dalam sampah. Sebagai seorang pemula, Anda mungkin masih berusaha mencari tahu "apa" dari kode itu, dan untuk itu Anda hanya perlu membaca dan memahami apa yang dia lakukan.
Yang penting untuk komentar adalah bahwa mereka mengatakan MENGAPA sebaris kode atau fungsi melakukan apa yang dilakukannya, di mana ini mungkin tidak jelas. Apakah Anda perlu mengatur modul X sebelum modul Y? Apakah penting untuk memeriksa kode kembali untuk melihat apakah suatu file sudah terbuka, atau apakah kita secara sadar mengabaikan kode kembali karena ini telah diperiksa di tempat lain? "Mengapa" kode akan relevan bagi semua orang, terlepas dari pengalaman - dan itu akan relevan baginya juga dalam waktu 6 bulan, ketika dia lupa tentang alasan yang baik untuk melakukan sesuatu dengan cara tertentu. Mengomentari bukan hanya untuk orang lain, itu untuk membantu Anda di masa depan juga.
Jika Anda ingin menghindari gangguan bos Anda, ajukan pertanyaan pintar. Berfokuslah pada pertanyaan tentang "mengapa", dan coba cari tahu sendiri "apa" (kecuali itu benar-benar tidak jelas). Tidak ada bos yang baik yang keberatan mengajukan pertanyaan jika itu bukan hal yang dapat Anda temukan dari R-ing TFM. Dan tidak ada insinyur yang baik akan keberatan diminta untuk melakukan sesuatu yang akan membuat hidup insinyur lain secara signifikan lebih mudah, dengan sedikit biaya bagi mereka. (Hanya saja jangan memintanya untuk mengisi komentar pada seluruh basis kode!;)