‫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.
‫Itu tidak berusaha 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 selalu 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.