Mari kita bicara tentang pengembang lain, fundamental, dan yang satu ini mengomentari kode Anda.
Sampai sekarang, Anda mungkin telah melihat saya berkomentar di komentar skrip kami.
Misalnya, di sini, saya menambahkan komentar boolean, dan ini memberi tahu juru bahasa Python, hei, ini komentar, jangan
jalankan ini, ini hanya untuk saya.
Anda bisa mengabaikannya dan melompat ke baris dua.
Dan Anda melihat itu.
Saya hanya melakukannya dengan Python dengan tanda.
Segera setelah Python melihat tanda pound, ia menambahkan komentar.
Dan Anda dapat melakukannya setelah satu baris juga.
Saya dapat mengatakan ini menetapkan ke variabel.
Dan meskipun ini mungkin terlihat seperti dua baris, sebenarnya hanya pembungkusan kata yang terjadi dan Anda
dapat melihat bahwa penerjemah mengabaikan komentar ini sepenuhnya.
Sekarang, berkomentar terdengar sangat, sangat sederhana, tetapi ini adalah konsep yang penting.
Dan jika Anda ingin menjadi programmer yang baik dalam semua bahasa, kami memiliki komentar.
Tapi ada hari baik dan cara buruk berkomentar.
Dan ini adalah sesuatu yang datang dengan latihan, tetapi berikut adalah beberapa pedoman utama.
Ketika Anda mengomentari kode Anda, idenya adalah Anda menambahkan komentar yang
berharga, yaitu, jika saya menambahkan komentar di sini yang mengatakan, hei, ini adalah variabel nama tanda, nilai kekuatan Andre, komentar seperti ini .
Tidak benar-benar baik.
Mengapa demikian?
Nah, karena kode Anda harus cukup jelas, bukan?
Idenya adalah agar kita menulis kode yang mudah dibaca, mudah dimengerti.
Ini tidak mencoba untuk menjadi pintar.
Sebaliknya, itu harus dibaca seperti bahasa Inggris.
Dan setiap programmer Python akan tahu itu di sini.
Kami hanya menambahkan Andre sebagai nilai nama.
Kami menetapkan variabel dan menambahkan komentar seperti ini yang cukup jelas hanya menambah kekacauan pada kode
Anda.
Jadi ada trade off di sini, ada baiknya mengomentari mantel Anda, katakanlah, jika Anda
bekerja dalam tim dan pengembang lain datang dan mereka ingin memahami kode Anda, tetapi Anda harus
ingat prinsip kode ini mudah dibaca .
Satu-satunya saat Anda ingin menambahkan komentar ke kode Anda adalah, ketika sesuatu yang sangat, sangat penting terjadi,
di mana mungkin sedikit rumit, Anda pertama-tama memutuskan, hei, apakah kode ini ditulis dengan cara
yang masuk akal?
Misalnya, jika ini adalah variabel A.
Dan ini adalah variabel B.
Nah, ini mungkin sangat sulit bagi seseorang untuk mengerti, jadi Anda bisa mengatakan bahwa ini adalah bendera yang
keren.
Tapi sebelum Anda menambahkan komentar itu, Anda ingin mengatakan pada diri sendiri, mungkin kode saya sulit
dibaca, mungkin saya harus mengubah variabelnya menjadi keren agar lebih mudah dipahami.
Sekarang, ini adalah sesuatu yang Anda perbaiki lebih dan lebih dan Anda ingin menggunakan komentar sebagai alat tambahan untuk membuat kode Anda dapat
dimengerti, mungkin Anda menulis kode yang enam bulan dari sekarang Anda ingin kembali untuk memahami
apa yang Anda lakukan.
Tapi ingat, lebih banyak komentar tidak berarti kode yang lebih baik.
Anda ingin ringkas dan menjaga hal-hal sederhana sambil menambahkan komentar hanya bila diperlukan untuk membantu orang lain memahami kode Anda, bukan
mencoba membuat kode Anda yang tidak dapat dibaca lebih mudah dibaca.
Kami akan menjelajahi topik ini dan memberi Anda saran tentangnya selama kursus.
Tapi ingat fundamental pengembang utama ini karena Anda akan membutuhkannya sepanjang karir Anda.
Omong-omong, artikel di sini memiliki beberapa poin penting yang menurut saya akan sangat bermanfaat bagi Anda, terutama dalam praktik terbaik berkomentar,
Anda dapat membaca beberapa hal yang harus dan tidak boleh dilakukan dan apa yang dilakukan oleh beberapa
programmer top ketika berkomentar.
Saya tahu kedengarannya konyol, tetapi ini adalah konsep penting yang diabaikan oleh sebagian besar kursus.
Jadi saya sangat menyarankan Anda membaca ini.
Saya akan menautkannya di sumber daya dan sampai jumpa di video berikutnya.