التعليقات
الدرس 20 من 28 في دورة Clean Code - كتابة كود أفضل باستخدام Python على Coddy.
إرشادات PEP 8 بشأن التعليقات:
- يجب ألا تتعارض التعليقات مع الكود
- يجب أن تكون التعليقات جملاً كاملة. يجب أن تبدأ الكلمة الأولى بحرف كبير
- يجب أن تحتوي التعليقات على مسافة بعد حرف
#. - يجب أن تحتوي التعليقات متعددة الأسطر المستخدمة في الدوال (docstrings) على وصف قصير من سطر واحد يتبعه نص إضافي
مرة أخرى، إذا كنت ترغب في معرفة المزيد، اقرأ مرجع PEP 8 الرسمي.
جرّب بنفسك
لا يتضمّن هذا الدرس تحدّيًا برمجيًا.