Apa Ukuran yang Tepat, Benarkah?
Tergantung pada bahasa yang Anda gunakan, tetapi secara umum (dan untuk selera pribadi saya):
- Idealnya , kurang dari 25 baris.
- Dapat diterima , kurang dari 35 baris.
Jika lebih, maka itu adalah sesuatu yang saya harus kembali lagi nanti dan mengerjakan ulang.
Tetapi secara realistis , ukuran apa pun yang diperlukan adalah ketika Anda perlu mengirimkan sesuatu dan bahwa lebih masuk akal saat ini untuk memuntahkannya, membuat kadang-kadang lebih mudah bagi seseorang untuk meninjau sebelum pengiriman. (tapi masih bisa kembali lagi nanti).
(Baru-baru ini tim saya menjalankan program pada basis kode kami: kami menemukan kelas dengan 197 metode dan yang lain hanya dengan 3 metode tetapi salah satunya adalah 600 baris. Permainan lucu: apa yang lebih buruk dari 2 kejahatan?)
Sekarang untuk jawaban yang lebih zen ... Secara umum itu dianggap praktik yang baik (TM) mengutip satu atau dua orang hebat, jadi begini:
Semuanya harus dibuat sesederhana mungkin, tetapi tidak sederhana. - A. Einstein
Kesempurnaan akhirnya tercapai bukan ketika tidak ada lagi yang ditambahkan, tetapi ketika tidak ada lagi yang bisa diambil. - A. de Saint Exupéry
Tambahan pada Gaya Komentar
Sebagai tambahan untuk ini, fungsi Anda harus memiliki nama yang jelas menjelaskan maksudnya. Mengenai komentar, saya biasanya tidak berkomentar di dalam suatu fungsi:
- komentar mengatakan "mengapa?" ,
- kode mengatakan "bagaimana?" .
Blok komentar di bagian atas setiap fungsi (yang membutuhkan penjelasan) sudah cukup. Jika fungsi Anda kecil dan nama fungsi cukup eksplisit, maka Anda hanya perlu mengatakan apa yang ingin Anda capai dan mengapa. Saya menggunakan komentar sebaris hanya untuk bidang dalam beberapa bahasa atau pada blok dimulai untuk fungsi yang melanggar aturan garis 25-35 jika maksudnya tidak jelas. Saya menggunakan komentar blok di dalam kode ketika situasi luar biasa terjadi (blok tangkapan di mana Anda tidak perlu atau ingin melakukan apa pun harus memiliki komentar yang mengatakan mengapa, misalnya).
Untuk lebih lanjut, silakan baca jawaban saya tentang Gaya dan rekomendasi kode komentar