يوم اكتشفت سحر الـ Commit الواضح
كانت بداية تجربتي مع البرمجة مليئة بالحماس، لكنها لم تخلُ من العثرات. في أحد المشاريع الأولى التي عملت عليها، كنت أعمل على تطوير ميزة جديدة لتطبيق صغير. كنت أجري تعديلات متسارعة، أضيف أسطرًا من الكود، أصلح أخطاء، وأحيانًا أغير أسماء المتغيرات فقط لأنها "لم تعجبني".
وفي كل مرة، كنت أسجل هذه التغييرات بـ commit واحد بسيط:
commit -m "Edits"
كنت أظن أن هذا كافٍ. بعد كل شيء، أنا أعرف ماذا أفعل، أليس كذلك؟
لكن بعد أسابيع، عندما احتجت للعودة إلى سجل التغييرات لفهم ما قمت به، واجهتني كارثة. كل ما رأيته هو سلسلة من الـ commits التي تقول "Edits"، "Changes"، أو "Fix stuff".
كأنني أقرأ يوميات شخص نسي ما كتب! ما الذي غيرته؟ هل كان إصلاحًا لخطأ في دالة الدفع؟ أم إضافة ميزة جديدة؟ استغرق الأمر ساعات من التدقيق في الكود لفهم ما حدث، وتسبب ذلك في تأخير تسليم المشروع.
هذه التجربة كانت نقطة تحول. قررت أن أغير نهجي تمامًا. بدأت أتعامل مع كل commit كقصة صغيرة تروي ما فعلته ولماذا.
على سبيل المثال، بدلاً من:
commit -m "Edits"
أصبحت أكتب:
commit -m "Fix null reference in payment validation method"
أو:
commit -m "Add user authentication endpoint to API"
فجأة، أصبح سجل التغييرات كتابًا مفتوحًا. كل commit أصبح واضحًا، يحمل هدفًا محددًا، ويسهل تتبعه أو التراجع عنه إذا لزم الأمر.
اكتشفت أن الـ commit الواضح ليس مجرد وصف تقني، بل هو احترام لنفسي في المستقبل، ولزملائي الذين سيعملون على نفس الكود، وللمشروع نفسه.
منذ ذلك اليوم، أصبحت أعامل كل commit كفرصة لتوثيق رحلة المشروع. الوضوح في الـ commits ليس مجرد تقنية، بل هو سحر يجعل العمل أكثر سلاسة ويحافظ على سلامة العقل!
