اذهب إلى المحتوى

السؤال

Recommended Posts

  • 0
نشر

ذلك طبيعي جدًا، ففي حال لم تقم بإضافة أية تعليقات على الأجزاء الرئيسية من الكود لتوضيح المنطق الخاص بتلك الأجزاء، لتصبح خريطة لك لاستيعاب ما يحدث عند العودة فيما بعد، أو لم تقم بتنظيم ملفات المشروع من خلال هيكل مجلدات مُنظم، أو طريقة كتابة الكود غير مُنظمة والتسميات غير واضحة، أو قمت بإنشاء المشروع من خلال إتباع شرح دونّ استيعاب ما تقوم به.

عامًة كلما طالت المدة، زاد النسيان، لذا عليك بالتعود على كتابة التعليقات:

# هذه الدالة تحسب متوسط المبيعات الشهرية
function calculateMonthlyAverage() {
  # نجمع المبيعات من قاعدة البيانات
    # ثم نقسم على عدد الأشهر
  
}

وعند الإنتهاء من المشروع اكتب ملف README مفصل، ووضح القرارات التقنية المهمة واشرح كيفية تشغيل المشروع.

والتسميات الواضحة:

//بدلاً من
function calc(x, y) {
    return x * y * 0.15;
}

//اكتب
function calculateTaxAmount(price, quantity) {
    const TAX_RATE = 0.15;
    return price * quantity * TAX_RATE;
}

 

  • 0
نشر

هذه مشكلة شائعة جداً ويواجهها كل المبرمجين تقريباً، سواء كانوا مبتدئين أو محترفين. فعقل الإنسان ليس مصمماً لتخزين كل التفاصيل البرمجية لمشاريع متعددة إلى الأبد. 

كما أنه كلما كان المشروع أكبر وأكثر تعقيداً، زادت احتمالية نسيان التفاصيل الدقيقة للأكواد. و إذا لم يكن هناك توثيق جيد أو تعليقات (comments) داخل الكود، يصبح من الصعب جداً تذكر سبب كتابة سطر معين أو وظيفة معينة.

ولذلك هناك بعض الممارسات لتسهيل العودة إلى المشاريع مثل 

  • استخدام التعليقات بشكل فعال داخل الكود لشرح الأجزاء المعقدة. 
  • كتابة أكواد واضحة ومقروءة قدر الإمكان. استخدم أسماء متغيرات ودوال ذات معنى، وقسم الكود إلى وحدات صغيرة ومنطقية.
  • كما أن وجود ملفات توثيق منفصلة (مثل ملف README.md) تشرح هيكل المشروع، كيفية تشغيله، والمكتبات المستخدمة أمر مهم 

وتذكر أن الهدف ليس أن تتذكر كل سطر من الكود، بل أن تبني عادات تساعدك على استعادة الذاكرة بسرعة وكفاءة عند الحاجة.

انضم إلى النقاش

يمكنك أن تنشر الآن وتسجل لاحقًا. إذا كان لديك حساب، فسجل الدخول الآن لتنشر باسم حسابك.

زائر
أجب على هذا السؤال...

×   لقد أضفت محتوى بخط أو تنسيق مختلف.   Restore formatting

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   جرى استعادة المحتوى السابق..   امسح المحرر

×   You cannot paste images directly. Upload or insert images from URL.

  • إعلانات

  • تابعنا على



×
×
  • أضف...