Yorumlara ve Kodun Okunabilirliğine Giriş

Yorumlar, kodu açıklamak ve daha okunabilir hale getirmek için kullanılır. Python yorumlayıcısı tarafından yok sayılır ve programın yürütülmesini etkilemezler.

Bu derste yorumları nasıl kullanacağınızı ve temiz, okunabilir kod yazmayı öğreneceksiniz.

Tek Satırlı Yorumlar

Tek satırlı yorumlar # ile başlar. O satırda # işaretinden sonra gelen her şey Python tarafından yok sayılır. Örneğin:

# This is a single-line comment
print("Hello, World!")

Çok Satırlı Yorumlar

Çok satırlı yorumlar üçlü tırnaklar (''' veya """) kullanılarak yazılabilir. Örneğin:

"""
This is a multi-line comment.
It spans multiple lines.
"""
print("Hello, World!")

Yorumlar Neden Kullanılır?

Yorumlar şunlara yardımcı olur:

• Karmaşık kodu açıklamaya.
• Kodu başkaları ve gelecekteki kendiniz için daha anlaşılır hale getirmeye.
• Hata ayıklamaya ve sorun gidermeye.

Yorumların insanlar için, makine için olmadığını unutmayın!

İyi Yorum Yazma Uygulamaları

İyi yorumlar yazmak için bazı ipuçları:

• Yorumları kısa ve anlamlı tutun.
• x = x + 1 için # Increment x by 1 gibi bariz yorumlardan kaçının.
• Kodun belirli bir şekilde neden yazıldığını açıklamak için yorumları kullanın.

Kodun Okunabilirliğini İyileştirme

Okunabilir kodun bakımı ve hata ayıklaması daha kolaydır. İşte bazı ipuçları:

• Anlamlı değişken ve işlev adları kullanın.
• Kod satırlarını kısa tutun.
• Yorumları kullanarak kodu bölümlere ayırın.

Kodu Yorum Satırına Alma

Hata ayıklama amacıyla kodu geçici olarak devre dışı bırakmak için yorumları kullanabilirsiniz. Örneğin:

# print("This line is commented out and won’t run.")
print("This line will run.")

Örnek: Bir İşlevi Belgeleme

İşlevleri belgelemek ve amaçlarını açıklamak için yorumları kullanabilirsiniz:

def greet(name):
    # This function greets the user by their name.
    print("Hello,", name)

greet("Alice")

Ne Öğrendik?

Bu derste şunları öğrendiniz:

• Python'da tek satırlı ve çok satırlı yorumların nasıl yazılacağını.
• Kodun okunabilirliği ve bakım kolaylığı açısından yorumların önemini.
• Yorum yazmak ve kodun okunabilirliğini iyileştirmek için en iyi uygulamaları.

Harika iş çıkardınız! Şimdi bir sonraki konuya geçelim.