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