التعليقات.
أسلوب مليء بتعليقات توضيحية.
##Signs and Symptoms
أسلوب مليء بتعليقات توضيحية.
##Reasons for the Problem
تُنشأ التعليقات عادةً بأفضل النوايا، عندما يدرك المؤلف أن كوده غير بديهي أو واضح. في مثل هذه الحالات، التعليقات تشبه مزيل العرق الذي يُخفي رائحة الكود المريب الذي يمكن تحسينه.
أفضل تعليق هو اسم جيد لأسلوب أو كلاس.
إذا شعرت أن مقطعاً من الكود لا يمكن فهمه دون تعليقات، حاول تغيير بنية الكود بطريقة تجعل التعليقات غير ضرورية.
##Treatment
##Payoff
- يصبح الكود أكثر بداهةً ووضوحاً.
