3. Python Comments (التعليقات)

التعليقات في بايثون (Comments)

التعليقات تُستخدم لتوضيح الكود، توثيقه، أو تعطيل أجزاء مؤقتًا.
البرنامج يتجاهلها تمامًا أثناء التنفيذ.

1. تعليق سطر واحد

# تعليق في سطر منفصل
score = 100           # النقاط الحالية للاعب
bonus = score * 2     # إضافة مكافأة مضاعفة
print(bonus)

2. تعليق متعدد الأسطر

"""
هذا تعليق طويل متعدد الأسطر
يمكن استخدامه كـ documentation string (docstring)
أو مجرد شرح عام للكود التالي
"""

'''
نفس الغرض باستخدام علامات اقتباس مفردة
يمكن أن يمتد على عدة أسطر
'''

print("Successfully implemented")   # هذا السطر فقط سيُطبع

نصيحة ذهبية:
ركّز في التعليقات على شرح السبب (Why) وليس فقط ما يحدث (What)، لأن الكود نفسه يُظهر ماذا يفعل، بينما التعليق الجيد يوضح لماذا اخترت هذا الحل.

تعليق واضح اليوم = ساعات أقل في فك التشابك غدًا (لك ولغيرك).