Başka bir geliştirici temelinden bahsedelim ve bu da kodunuzu yorumlamaktır.
Şimdiye kadar beni yorum yaparken, senaryolarımıza yorumlar eklerken görmüş olabilirsiniz.
Örneğin, tam buraya Boolean'lardan oluşan bir yorum ekledim ve bu Python yorumlayıcısına şunu söylüyor: Hey, bu
bir yorum, bunu çalıştırma.
Sadece benim için.
Bunu görmezden gelebilir ve ikinci satıra geçebilirsiniz.
Ve sen bunu gördün mü?
Bunu Python'da basitçe pound işareti ile yaptım.
Python bir pound işareti görür görmez bir yorum ekler ve bunu bir satırdan sonra da yapabilirsiniz.
Bunun bir değişkene atandığını söyleyebilirim.
Ve bu iki satır gibi görünse de, aslında gerçekleşen sadece koğuş rap'idir.
Ve yorumlayıcının bu yorumları tamamen görmezden geldiğini görebilirsiniz.
Şimdi, yorum yapmak kulağa çok ama çok basit geliyor, ancak önemli bir kavram.
Ve eğer tüm dillerde iyi bir programcı olmak istiyorsanız, yorumlarımız var.
Ancak yorum yapmanın iyi ve kötü yolları vardır.
Ve bu pratikle gelen bir şeydir.
Ancak burada bazı temel kurallar bulunmaktadır.
Kodunuzu yorumladığınızda, değerli yorumlar eklemiş olursunuz.
Yani, buraya şöyle bir yorum eklersem, Hey, bu bir işaret adı değişkeni, Andre dizesinin bir değeri,
bunun gibi bir yorum.
Gerçekten iyi değil.
Nedenmiş o?
Çünkü kodunuz kendi kendini açıklıyor olmalı, değil mi?
Buradaki fikir, okunması ve anlaşılması kolay kodlar yazmamızdır.
Zeki olmaya çalışmıyor.
Bunun yerine, İngilizce gibi okunmalıdır.
Ve herhangi bir python programcısı burada sadece Andre'yi ismin bir değeri olarak eklediğimizi bilir.
Bir değişken atıyoruz ve bunun gibi kendi kendini açıklayan bir yorum ekliyoruz.
Sadece kodunuza dağınıklık katar.
Yani burada bir değiş tokuş var.
Diyelim ki takımlarda çalışıyorsanız ve diğer geliştiriciler gelip kodunuzu anlamak istiyorlarsa kodunuzu
yorumlamak iyidir.
Ancak kodun kolay okunabilir olması ilkesini unutmamalısınız.
Kodunuza yorum eklemek istediğiniz tek zaman.
Gerçekten çok önemli bir şey olduğunda, biraz karmaşık olabileceği durumlarda, önce şuna
karar verirsiniz: Hey, bu kod mantıklı bir şekilde yazılmış mı?
Örneğin, bu a değişkeni olsaydı.
Bu da B değişkeniydi.
Bunu anlamak birileri için gerçekten zor olabilir.
Yani bunun bir bayrak olduğunu söyleyebilirsiniz.
Ancak bu yorumu eklemeden önce kendinize şunu söylemek istersiniz: Hmm, belki de kodumun okunması zordur.
Belki de daha anlaşılır olması için değişkeni is cool olarak değiştirmeliyim.
Şimdi bu, giderek daha fazla geliştirdiğiniz bir şeydir ve yorumları kodunuzu anlaşılır hale getirmek için ekstra bir araç
olarak kullanmak istersiniz.
Belki de bundan altı ay sonra ne yaptığınızı anlamak için geri dönmek isteyeceğiniz bir kod yazıyorsunuz.
Ancak unutmayın, daha fazla yorum mutlaka daha iyi kod anlamına gelmez.
Okunamayan kodunuzu daha okunabilir hale getirmeye çalışmadan, yalnızca başkalarının kodunuzu anlamasına yardımcı olmak için gerekli
olduğunda yorumlar eklerken kısa ve öz olmak ve işleri basit tutmak istersiniz.
Kurs boyunca bu konuyu inceleyecek ve size tavsiyelerde bulunacağız.
Ancak bu önemli geliştirici temelini unutmayın çünkü kariyeriniz boyunca buna ihtiyacınız olacak.
Bu arada, şuradaki makalede gerçekten faydalanacağınızı düşündüğüm bazı önemli noktalar var, özellikle
de en iyi yorum yapma uygulamalarında.
Yapılması ve yapılmaması gerekenlerden bazılarını ve en iyi programcılardan bazılarının yorum yaparken neler yaptığını okuyabilirsiniz.
Kulağa aptalca geldiğini biliyorum, ancak çoğu kursun gözden kaçırdığı önemli bir kavram, bu yüzden bunu okumanızı
şiddetle tavsiye ederim.
Kaynaklarda linkini vereceğim ve bir sonraki videoda görüşmek üzere.