‫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 ama ö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.