التعليقات الكتلية

«إذا كان من الصعب شرح التنفيذ، فهذه فكرة سيئة.»

- Zen of Python

التعليقات مهمة حتى يتمكن أي شخص سيقرأ شفرتك من فهمها.

تنقسم التعليقات في Python إلى 3 أنواع:

• التعليقات الكتلية
• التعليقات المضمنة
• سلاسل التوثيق

لنبدأ بـ التعليقات الكتلية -

• تبدأ من مستوى المسافة البادئة نفسه للكتلة البرمجية التي تصفها.
• ابدأ كل سطر بالرمز # متبوعًا بمسافة واحدة.

على سبيل المثال،

while i < 10:
    # كرر الحلقة على i حتى i < 10
    # اطبع i مع سطر جديد وزدها بمقدار 1
    print(i, '\n')
    i += 1