Mengomentari saat ini lebih mudah dari sebelumnya. Di Java, ada beberapa teknik yang bagus untuk menghubungkan komentar ke kelas, dan Java IDEs bagus dalam membuat shell komentar untuk Anda. Bahasa seperti Clojure bahkan memungkinkan Anda untuk menambahkan deskripsi fungsi dalam kode fungsi itu sendiri sebagai argumen.
Namun kami masih hidup di zaman di mana sering ada komentar usang atau buruk yang ditulis oleh pengembang yang baik - Saya tertarik untuk meningkatkan kekokohan dan kegunaan komentar saya.
Khususnya saya tertarik pada Java / Clojure / Python di sini, tetapi jawaban tidak perlu spesifik bahasa.
Apakah ada teknik baru yang memvalidasi komentar dan secara otomatis mendeteksi komentar "tipis" (misalnya komentar dengan angka ajaib, kalimat tidak lengkap, dll.) Atau komentar yang salah (misalnya, mendeteksi variabel yang salah eja atau sejenisnya).
Dan yang lebih penting: Apakah ada "kebijakan komentar" yang diterima atau strategi di luar sana? Ada banyak saran di luar sana tentang cara kode - tetapi bagaimana dengan "bagaimana berkomentar?"