الخطأ الشنيع الذي يقوم به أغلب المبرمجين:
"كود بدون تعليقات"
المشكلة فيها كمية خلاف كبيرة جدا جدا
وتجد بعض المبرمجين يقولوا لك: خلي كودك مفهوم بدون تعليقات أفضل
الواقع مختلف يا عزيزي...
هذا الثريد خلاصة لسنوات من التجربة مع الأكواد بدون تعليقات
"كود بدون تعليقات"
المشكلة فيها كمية خلاف كبيرة جدا جدا
وتجد بعض المبرمجين يقولوا لك: خلي كودك مفهوم بدون تعليقات أفضل
الواقع مختلف يا عزيزي...
هذا الثريد خلاصة لسنوات من التجربة مع الأكواد بدون تعليقات
صحيح جدا، يجب أن يكون الكود خاصتك clean code
مقروء ومفهوم وقابل للتعديل والاختبار unit testing بسهولة عالية
وهذا يعني أنك لو وجدت الحاجة لكتابة
"هذا الكود يقوم بكذا كذا عن طريق حساب كذا كذا"
غالبا معناه أنك جبت العيد، والكود سيء لدرجة أنك تحتاج تشرحه في تعليق
مقروء ومفهوم وقابل للتعديل والاختبار unit testing بسهولة عالية
وهذا يعني أنك لو وجدت الحاجة لكتابة
"هذا الكود يقوم بكذا كذا عن طريق حساب كذا كذا"
غالبا معناه أنك جبت العيد، والكود سيء لدرجة أنك تحتاج تشرحه في تعليق
القاعدة الذهبية:
التعليقات لو مشابهه للكود، معناه يمكن تحسين الكود والاستغناء عن التعليقات
السؤال الذي يروادني لو قرأت هذا المثال السيء:
"ماهو sal؟ مبيعات sales؟ أو مرتب salary؟ وليش مضروب بالرقم 0.05؟"
وبحتاج أقرأ الكويري كاملة وأفهم الفكرة، وربما ما أفهمها!!
التعليقات لو مشابهه للكود، معناه يمكن تحسين الكود والاستغناء عن التعليقات
السؤال الذي يروادني لو قرأت هذا المثال السيء:
"ماهو sal؟ مبيعات sales؟ أو مرتب salary؟ وليش مضروب بالرقم 0.05؟"
وبحتاج أقرأ الكويري كاملة وأفهم الفكرة، وربما ما أفهمها!!
إذا، ماهي فائدة التعليقات؟
لا يخفى على اثنين أنه كل تطبيق مبني على "قواعد عمل" business rules
مثلا الكويري بالأعلى عبارة عن تنفيذ لقاعدة:
"الموظف الذي ينجح بمبيعات فوق 10 ألف في الشهر، يستحق مكافئة زيادة 5%"
لا يخفى على اثنين أنه كل تطبيق مبني على "قواعد عمل" business rules
مثلا الكويري بالأعلى عبارة عن تنفيذ لقاعدة:
"الموظف الذي ينجح بمبيعات فوق 10 ألف في الشهر، يستحق مكافئة زيادة 5%"
ربما تتساءل: ماهي فائدة كتابة قواعد العمل business rules داخل الأكواد؟
تخيل معي عندك فريق برمجة، وكل واحد كتب أجزاء من البرمجية بدون أي تعليقات
بعد فترة عندك موظفين جدد...
بتجلس تشرح لهم كل قواعد العمل أول وجديد؟ أو بتجلب الفريق يشرح لهم كل الكود؟!
أعتقد وصلت الفكرة ?
تخيل معي عندك فريق برمجة، وكل واحد كتب أجزاء من البرمجية بدون أي تعليقات
بعد فترة عندك موظفين جدد...
بتجلس تشرح لهم كل قواعد العمل أول وجديد؟ أو بتجلب الفريق يشرح لهم كل الكود؟!
أعتقد وصلت الفكرة ?
جاري تحميل الاقتراحات...