التعليقات السطرية
الدرس 7 من 28 في دورة Clean Code - كتابة كود أفضل باستخدام Python على Coddy.
تشرح التعليقات المضمّنة عبارةً واحدةً في جزء من التعليمات البرمجية.
- اكتب التعليقات المضمّنة في السطر نفسه الذي توجد فيه العبارة التي تشير إليها.
- افصل التعليقات المضمّنة عن العبارة بمسافتين أو أكثر.
- تبدأ بـ
#ومسافة واحدة. - لا تستخدمها لشرح الأمور البديهية.
على سبيل المثال،
result = check(name) # تحقق مما إذا كان name جيدًافي معظم الأحيان، ستفضّل استخدام كتل التعليقات بدلًا من الكتل المضمّنة.
التحدي
سهللديك شفرة صغيرة تُجري عملية حسابية بسيطة لزيادة salary، اكتب تعليقًا مضمنًا يشرح هذا السطر.
قد يكون هذا شرحًا واضحًا على الأرجح، لكن من أجل تدريبنا سنفعله...
جرّب بنفسك
salary = 1000
salary = salary * 1.05جميع دروس Clean Code - كتابة كود أفضل باستخدام Python
تدرّب بنفسك: مترجم Python عبر الإنترنت