في أول أسبوع لك في فريق برمجي جديد سوف تسمع جملاً مثل هذه: «لا تدخل في هذا الـ Rabbit Hole الآن»، و«الاجتماع تحول إلى Bikeshedding»، و«قضيت اليوم كله Yak Shaving»، و«التغيير LGTM ما عدا Nit صغير»، و«الـ Bus Factor عندنا في هذه الخدمة واحد». وقد تهز رأسك وكأنك فهمت، ثم تبحث عنها لاحقاً في Google. هذه ليست مصطلحات تقنية بالمعنى الدقيق، فلن تجدها في توثيق لغة برمجة أو في منهج جامعي، ولكنها لغة يومية يتفاهم بها المبرمجون حول العالم، وكثير منها يحمل فكرة عن طريقة العمل أعمق مما يبدو من شكله الطريف.
والجميل أن أغلب هذه الكلمات لها أصل موثق يمكن أن تتتبعه: وثيقة رسمية من وثائق الإنترنت، أو رسالة بريد إلكتروني في قائمة مطوري FreeBSD، أو تقرير في مؤتمر علمي، أو سجل تشغيل حاسب من 1947 ما زالت فيه فراشة ملصقة. ومرجعنا الأول هو ملف المصطلحات Jargon File الذي جمع فيه المبرمجون لغتهم منذ 1975، وتجد نسخة منه في مشروع Gutenberg، ومعه المصادر الأصلية لكل كلمة حيث وجدناها. وقد رويت قصة هذا الملف وكلمات مثل Hacker وGeek في مقال المهندس الشامل، أما هذا المقال فعن الكلمات التي تستخدمها في يوم العمل نفسه.
ولكي لا تكون قائمة كلمات جافة، سوف نتابع أسبوعاً واحداً في فريق صغير متخيل: أربعة مبرمجين في شركة ناشئة تبني تطبيقاً لحجز مواعيد العيادات، وقائدة فريق اسمها سارة، ومبرمج جديد انضم هذا الأسبوع اسمه خالد. والفريق والمواقف مثال توضيحي للسياق الذي تستخدم فيه كل كلمة، أما أصول الكلمات فكلها من مصادرها.
وسوف نناقش في هذا المقال ما يلي:
- كلمات الكود: foo وbar، والرقم السحري Magic Number، وكود السباغيتي Spaghetti Code، والـ Kludge، والبرمجة على طريقة عبادة الشحنات Cargo Cult Programming.
- كلمات تتبع الأخطاء: Bug وقصة الفراشة، وHeisenbug، والبطة المطاطية Rubber Duck، وShotgun Debugging، وجحر الأرنب Rabbit Hole.
- كلمات النقاش: Bikeshedding وقانون Parkinson، وYak Shaving، وRTFM.
- كلمات مراجعة الكود: LGTM وNit.
- كلمات إدارة المشروع: الدين التقني Technical Debt، وعامل الحافلة Bus Factor، وDogfooding، وShip.
- كيف تستخدم هذه الكلمات في فريق عربي دون أن تتحول إلى حاجز أمام الجدد.

كلمات الكود Code: ما تراه في الملفات
يوم الأحد، أول يوم لخالد. يفتح سجل المشروع ليقرأ الكود، وأول ما يلاحظه أن أمثلة الاختبارات مليئة بأسماء مثل foo وbar، وأن في دالة حساب مدة الموعد رقماً غريباً لا يشرحه أحد، وأن ملفاً قديماً اسمه legacy_booking.js يتجنبه الجميع.
الأسماء الوهمية Metasyntactic Variables: foo / bar
أكثر كلمتين تراهما في أمثلة البرمجة هما foo وbar، وهما ما يسمى المتغيرات الوهمية Metasyntactic Variables، أي أسماء لا معنى لها تستخدمها عندما تريد أن تقول «أي شيء». ولهما وثيقة رسمية خاصة: RFC 3092 بعنوان Etymology of "Foo"، أي أصل كلمة Foo، صدرت في 1 أبريل 2001، ويقول ملخصها إن قرابة 212 وثيقة RFC، أي حوالي 7% من الوثائق حتى ذلك الوقت، بدءاً من RFC 269، تستخدم foo أو bar أو foobar دون أي شرح، وإن هذا سبب مشاكل للقادمين الجدد، خاصة من لا تكون الإنجليزية لغتهم الأولى، فجاءت الوثيقة لتسد هذا النقص. ولاحظ تاريخ الصدور، فوثائق الأول من أبريل في IETF تقليد معروف للمزاح، ولكن هذه الوثيقة بالذات مفيدة فعلاً.
أما الأصل نفسه فيرويه مدخل foo في Jargon File، والذي اعتمدت عليه الوثيقة. فأقدم استخدامات موثقة للكلمة كانت في قصة مصورة اسمها Smokey Stover نشرت من حوالي 1930 إلى حوالي 1952، وكان مؤلفها Bill Holman يملأ رسوماته بعبارات لا معنى لها، ومنها foo على لوحات السيارات وفي الخلفيات. ويذكر الملف أن Holman قال إنه وجد الكلمة على قاعدة تمثال صيني، وأن هذا معقول لأن كلمة fu الصينية قد تعني السعادة. وأما foobar فيرجح الملف أنها مرتبطة بتعبير FUBAR العسكري من الحرب العالمية الثانية، ومعناه أن الشيء تعطل تماماً. ويضيف مدخل TMRC في نفس الملف تفصيلاً جميلاً: في نادي القطارات في MIT كانت هناك مفاتيح طوارئ إذا ضغطت توقف الساعة الرقمية على لوحة التحكم وتعرض كلمة FOO، ولذلك سميت هناك Foo Switches.
والدرس العملي هنا صغير ولكنه مهم: foo وbar مناسبتان للأمثلة فقط. فإذا وجدتهما في كود الإنتاج، فهذا يعني أن أحداً نسي أن يسمي الشيء باسمه الحقيقي، والاسم الجيد هو أول توثيق للكود.
الرقم السحري Magic Number
والرقم الغريب الذي وجده خالد في دالة حساب المدة له اسم: Magic Number. ويعرفه Jargon File في معناه الأول بأنه ثابت غير واضح في الكود المصدري، قيمته مهمة لعمل البرنامج، ومكتوب مباشرة داخل السطر Hardcoded بدل أن يعرف باسم له تعليق، ويقول بوضوح إن الأرقام السحرية بهذا المعنى أسلوب سيئ. فإذا رأيت في الكود if (duration > 2700) فلن تعرف أن 2700 ثانية هي 45 دقيقة، وأنها أطول مدة يسمح بها لموعد، إلا إذا سألت من كتبها.
وللكلمة معنى آخر يذكره الملف، وهو أقدم: بيانات خاصة في بداية ملف ثنائي تخبر البرامج بنوعه، مثل %! في بداية ملفات PostScript، أو القيمة 0407 التي كانت في بداية الملفات التنفيذية القديمة في Unix، وكانت في الأصل تعليمة انتقال Branch على حواسيب PDP-11 تتخطى رأس الملف. وهذا المعنى ما زال حياً، فأداة file في Linux تعرف نوع أي ملف بقراءة رقمه السحري.
كود السباغيتي Spaghetti Code
أما الملف الذي يتجنبه الجميع فيوصف عادة بأنه Spaghetti Code. ويعرفه Jargon File بأنه كود له بنية تحكم معقدة ومتشابكة، خاصة إذا استخدم كثيراً من أوامر GOTO أو الاستثناءات أو غيرها من التفرعات غير المنظمة، ويذكر أنه وصف سلبي. والصورة واضحة: إذا حاولت أن تتبع مسار التنفيذ فيه بإصبعك، فسوف تجد نفسك تسحب خيطاً من طبق معكرونة لا تعرف أين ينتهي.
والكلمة اليوم لا تخص GOTO وحده، فقد ترى Spaghetti في كود حديث جداً: دوال تستدعي بعضها في دوائر، وأحداث Events تطلق أحداثاً أخرى، وحالة مشتركة يعدلها كل جزء من البرنامج. وقد شرحنا في مقال ما هي جودة الكود وكيف تقيسها مقاييس مثل التعقيد الدوري Cyclomatic Complexity التي تحول هذا الوصف إلى رقم.
الحل المرقع Kludge
وفي نفس الملف القديم سطر عليه تعليق يقول إنه «Kludge مؤقت». ولهذه الكلمة واحد من أطول المداخل في Jargon File. فمعانيها: جهاز معقد بشكل مضحك يؤدي وظيفة بسيطة، وحيلة برمجية ذكية تحل حالة صعبة بطريقة سريعة وغير واضحة، وكثيراً ما تستخدم لإصلاح الأخطاء، وشيء يعمل للسبب الخطأ. ويقول الملف إن التهجئة الأصلية كانت kluge، وإنها سجلت حول الحواسيب منذ منتصف الخمسينيات، وإنها كانت في عامية البحرية الأمريكية في الحرب العالمية الثانية تعني أي جهاز إلكتروني يعمل جيداً على الشاطئ ويتعطل باستمرار في البحر.
والمعنى الثالث، شيء يعمل للسبب الخطأ، هو أخطر هذه المعاني في فريق حقيقي. فالكود الذي يعمل وأنت لا تعرف لماذا سوف يتوقف يوماً وأنت لا تعرف لماذا أيضاً.
البرمجة على طريقة عبادة الشحنات Cargo Cult Programming
وعندما سأل خالد عن سطر غريب في إعدادات الخادم، قال له زميله: «لا أعرف لماذا هو هنا، ولكن لا تحذفه، فقد حدثت مشكلة مرة عندما حذفناه». وهذا بالضبط ما يسميه Jargon File البرمجة على طريقة عبادة الشحنات Cargo Cult Programming: أسلوب برمجة يسيطر عليه إدخال كود أو هياكل لا تخدم غرضاً حقيقياً بطريقة طقوسية، ويفسرها المبرمج عادة بأنها تتجنب خطأً حدث في الماضي، ولكن لا الخطأ ولا سبب اختفائه فهمه أحد.
والتسمية تشير إلى طقوس ظهرت في جزر جنوب المحيط الهادئ بعد الحرب العالمية الثانية، حيث بنى بعض السكان نماذج للطائرات ومدارج تشبه المدارج العسكرية، أملاً في عودة الطائرات التي جلبت لهم البضائع أثناء الحرب. ويرجح الملف أن استخدام المبرمجين جاء من وصف عالم الفيزياء Richard Feynman لبعض الممارسات بأنها «علم عبادة الشحنات» Cargo Cult Science، وهو عنوان خطابه في حفل تخرج جامعة Caltech سنة 1974، حيث وصف كيف رتب السكان مدارج وأشعلوا النار على جانبيها وانتظروا هبوط الطائرات، ولكن الطائرات لم تهبط. وكان درسه للطلاب عن نوع من النزاهة العلمية يشبه الأمانة الكاملة: أن تذكر كل ما يمكن أن يجعل نتيجتك خاطئة.
والعلاج في البرمجة هو نفس علاج Feynman: لا تبق سطراً لا تعرف سببه دون أن تسجل سؤالاً عنه. اكتب تعليقاً يشرح لماذا هذا السطر هنا، أو احذفه في بيئة اختبار وراقب ما يحدث، ولكن لا تتركه طقساً يتوارثه الفريق.
كلمات تتبع الأخطاء Debugging
يوم الاثنين، يصل بلاغ من عيادة: بعض المواعيد تحجز مرتين. يجلس خالد مع سارة لتتبع الخطأ، وفي هذا اليوم وحده يسمع خمس كلمات جديدة.
الخطأ البرمجي Bug: قصة الفراشة
أشهر كلمة في المهنة لها قصة يرويها الجميع، ولكن أغلبهم يرويها خطأ. فالقصة الشائعة أن كلمة Bug ولدت عندما وجد فريق Grace Hopper فراشة داخل حاسب. والصحيح، كما يقول مدخل bug في Jargon File، أن الفراشة وجدت فعلاً في 9 سبتمبر 1947 عالقة بين نقاط التلامس في المرحل Relay رقم 70 في اللوحة F من حاسب Harvard Mark II، وأن المشغلين ألصقوها في سجل التشغيل وكتبوا بجانبها «أول حالة فعلية لوجود حشرة». وكلمة «فعلية» هنا هي المفتاح، فهي تثبت أن كلمة Bug بمعنى الخلل كانت مستخدمة قبلها، وأن المزحة كانت في أن الخلل هذه المرة حشرة حقيقية. ويذكر الملف أن Hopper كانت تحب رواية القصة، وكانت حريصة على الاعتراف بأنها لم تكن حاضرة عندما حدثت.

وتوضح صفحة الصورة في Wikimedia Commons خطأً آخر في القصة: متحف البحرية الذي عرض السجل لسنوات أرخه خطأً بسنة 1945، بينما التاريخ الصحيح 1947، لأن حاسب Mark II لم يكتمل إلا في صيف 1947. وهذه المفارقة تستحق الابتسام: حتى قصة أول Bug فيها Bug. وقد كتبنا عن أدوات تتبع الأخطاء الحديثة في مقال قراءة رسالة الخطأ والتصحيح Debugging.
الخطأ الذي يختفي Heisenbug
وعندما أضاف خالد سطور طباعة ليرى ما يحدث، اختفى الحجز المزدوج. ثم حذفها فعاد. قالت سارة: «هذا Heisenbug». ويعرفه Jargon File بأنه خطأ يختفي أو يتغير سلوكه عندما تحاول أن تفحصه أو تعزله، والاسم مأخوذ من مبدأ عدم التحديد عند Heisenberg في فيزياء الكم، حيث تغير عملية القياس نفسها ما تقيسه. ويقول الملف إن هذا ليس خيالاً، فاستخدام منقح الأخطاء Debugger يغير أحياناً بيئة تشغيل البرنامج بما يكفي لأن يتصرف الكود الخاطئ بطريقة مختلفة، ويذكر أن تسعة من كل عشرة Heisenbugs في لغة C سببها متغيرات لم تعط قيمة أولية، أو تخريب في الذاكرة.
وعكسه في الملف Bohr Bug، نسبة إلى نموذج Bohr للذرة: خطأ يتكرر بثبات تحت مجموعة شروط محددة، حتى لو لم تكن تعرفها بعد. وفي حالة فريقنا، فإن أغلب الأخطاء التي تختفي عندما تضيف سطور طباعة سببها التوقيت، فسطر الطباعة يبطئ الكود قليلاً فيغير ترتيب طلبين متزامنين، والحجز المزدوج مثال كلاسيكي على حالة سباق Race Condition بين طلبين يحجزان نفس الموعد في نفس اللحظة.
البطة المطاطية Rubber Duck Debugging
بعد ساعة من المحاولة، وضعت سارة بطة مطاطية صفراء على مكتب خالد وقالت: «اشرح لها الكود سطراً سطراً». وهذه ليست مزحة، فهي طريقة معروفة في تتبع الأخطاء اسمها Rubber Duck Debugging، وانتشرت مع كتاب The Pragmatic Programmer لمؤلفيه Andrew Hunt وDavid Thomas، والذي صدرت طبعته الأولى في 1999، حيث يذكر الكتاب أسلوب Rubber Ducking ضمن نصائح تتبع الأخطاء.
ويلخص موقع Rubber Duck Debugging الطريقة بخطوات بسيطة: احصل على بطة مطاطية، وضعها على مكتبك وأخبرها أنك ستراجع معها بعض الكود، ثم اشرح لها ما يفترض أن يفعله الكود، ثم اشرح كل سطر بالتفصيل. وفي لحظة ما سوف تقول للبطة ما الذي تفعله الخطوة التالية، ثم تدرك أن هذا ليس ما يفعله الكود فعلاً. والسر ليس في البطة طبعاً، وإنما في أن الشرح بصوت عال يجبرك على أن تقرأ ما كتبته فعلاً، لا ما تظن أنك كتبته.

وفي فريقنا، عندما وصل خالد إلى السطر الذي يتحقق من توفر الموعد ثم يحجزه، قال للبطة: «هنا نتأكد أن الموعد متاح، ثم نحجزه»، ثم توقف. فبين التأكد والحجز لا شيء يمنع طلباً آخر من أن يفعل نفس الشيء في نفس اللحظة. والحل المعروف أن يتم التأكد والحجز في عملية واحدة ذرية Atomic في قاعدة البيانات، مثل قيد فريد Unique Constraint على العيادة والوقت.
تتبع الأخطاء بالبندقية Shotgun Debugging
وقبل البطة، كان خالد قد جرب شيئاً آخر: غير ترتيب بعض السطور، وأضاف انتظاراً قصيراً، وغير إصدار مكتبة، على أمل أن يختفي الخطأ. ولهذا الأسلوب اسم في Jargon File: Shotgun Debugging، أي إجراء تغييرات عشوائية تقريباً في البرنامج على أمل أن يختفي الخطأ من الاهتزاز. ويقول الملف بصراحة إنه لا ينجح تقريباً أبداً، وإنه عادة يضيف أخطاء جديدة. والأسوأ أنه حتى عندما «ينجح»، فأنت لا تعرف لماذا، وهكذا يولد سطر Cargo Cult جديد.
جحر الأرنب Rabbit Hole
وفي منتصف اليوم بدأ خالد يقرأ عن طريقة عمل الأقفال Locks في قاعدة البيانات، ثم عن مستويات العزل Isolation Levels، ثم عن تاريخها في الأوراق العلمية، فقالت له سارة: «لا تنزل في هذا الـ Rabbit Hole الآن». والتعبير من الفصل الأول في رواية Lewis Carroll Alice's Adventures in Wonderland سنة 1865، وعنوانه Down the Rabbit-Hole، حيث تتبع Alice أرنباً إلى جحره فتسقط في عالم لا تنتهي غرابته. وفي لغة المبرمجين يعني أن تبدأ في موضوع جانبي فيأخذك إلى موضوع آخر ثم آخر، حتى تنسى لماذا بدأت. والفرق بينه وبين Yak Shaving الذي سنصل إليه أن جحر الأرنب غالباً ممتع وغير ضروري، أما حلاقة الثور فضرورية ومملة.
كلمات النقاش Discussion: ما تسمعه في الاجتماعات
يوم الثلاثاء، اجتماع الفريق الأسبوعي. على جدول الأعمال بندان: تغيير طريقة تخزين المواعيد لحل مشكلة الحجز المزدوج، واختيار لون زر «احجز الآن» في التطبيق.
لون مظلة الدراجات Bikeshedding
استغرق البند الأول خمس دقائق، فالجميع وافق على اقتراح سارة دون أسئلة كثيرة. واستغرق البند الثاني ساعة كاملة، فلكل شخص رأي في اللون. وهذه الظاهرة لها اسم: Bikeshedding. ويعرفها Jargon File بأنها خلافات تقنية حول قضايا صغيرة وهامشية، بينما يتم تجاهل القضايا الأخطر، والصورة أن الناس يتجادلون في لون مظلة الدراجات بينما البيت نفسه لم يكتمل.
وللكلمة أصل موثق في رسالة بريد إلكتروني. ففي 2 أكتوبر 1999 أرسل Poul-Henning Kamp، أحد مطوري FreeBSD، رسالة إلى قائمة المطورين بعد نقاش طويل جداً حول تغيير صغير، يشرح فيها الظاهرة بمثال من كتاب C. Northcote Parkinson عن قانون Parkinson. والمثال أن مجلس إدارة يوافق بسرعة على بناء محطة طاقة ذرية بمليارات، لأنها ضخمة ومعقدة لدرجة أن أحداً لا يستطيع أن يستوعبها، فيفترض الجميع أن غيرهم راجع التفاصيل. أما مظلة الدراجات فيستطيع أي شخص أن يبنيها في عطلة نهاية الأسبوع ويبقى عنده وقت لمشاهدة المباراة، كما يقول Kamp، فيشعر الجميع أن لهم رأياً، ويطول النقاش بلا نهاية.

ويلخص سؤال FreeBSD FAQ عن لون المظلة الفكرة في جملة واحدة: حجم الضجيج الذي يثيره تغيير يتناسب عكسياً مع تعقيده. ويجيب عن سؤال «لماذا يجب أن أهتم بلون المظلة؟» بإجابة قصيرة: لا يجب. والمقصود أنك لست مضطراً أن تجادل في كل تفصيل صغير لمجرد أنك تعرف ما يكفي لتجادل فيه.
والخطر الحقيقي في قصة فريقنا ليس الساعة الضائعة في لون الزر، وإنما الدقائق الخمس في تغيير التخزين. فالقرار الأخطر مر دون أن يسأل أحد عن مخاطره، لأنه معقد. والعلاج العملي أن تضع وقتاً محدداً للقرارات الصغيرة، وأن تطلب من شخص محدد أن يلعب دور المعارض في القرارات الكبيرة.
حلاقة الثور Yak Shaving
يوم الأربعاء، بدأ خالد في إصلاح الحجز المزدوج. ولكن الاختبارات لم تعمل على جهازه، لأنها تحتاج إصداراً أحدث من مكتبة الاختبار، والمكتبة تحتاج إصداراً أحدث من Node، وNode الجديد لا يعمل مع أداة البناء القديمة، وهكذا. وفي نهاية اليوم كان خالد يحدث أداة البناء في المشروع كله، ولم يلمس سطراً من الإصلاح الأصلي. قالت سارة: «قضيت اليوم في Yak Shaving».

ويعرفها Jargon File بأنها أي نشاط يبدو بلا فائدة، ولكنه ضروري فعلاً لحل مشكلة، تحل مشكلة، تحل بعد عدة مستويات من التكرار المشكلة الحقيقية التي تعمل عليها. ويقول الملف إن الكلمة ظهرت في مختبر الذكاء الاصطناعي في MIT بعد سنة 2000، وأصلها على الأرجح حلقة من مسلسل الرسوم المتحركة Ren & Stimpy. ولاحظ أن التعريف نفسه مكتوب بشكل تكراري Recursive، مثل الدالة التي تستدعي نفسها، وهذه مزحة مقصودة من المبرمجين.
والفرق المهم بين Yak Shaving وRabbit Hole أن الأولى ضرورية. فخالد لا يستطيع أن يصلح الخطأ دون أن تعمل الاختبارات. ولكن السؤال الذي يجب أن يسأله في كل مستوى: هل هناك طريق أقصر؟ ربما يستطيع أن يشغل الاختبارات في حاوية Docker فيها البيئة الصحيحة بدل أن يحدث جهازه، أو أن يطلب من زميل مر بنفس المشكلة. فأحياناً أفضل طريقة لحلاقة الثور هي أن تجد من حلقه قبلك.
اقرأ الدليل RTFM
وفي نفس اليوم سأل خالد في قناة الفريق عن خيار في أداة البناء، فرد عليه زميل بأربعة حروف: RTFM. وهي اختصار يعرفه Jargon File بأنه من ثقافة Unix، ومعناه «اقرأ الدليل» مع كلمة بذيئة في الوسط، وله معنيان. الأول يستخدمه الخبراء Gurus ليتخلصوا من الأسئلة التي يرونها بسيطة أو مزعجة. والثاني مهذب: عندما تبلغ عن مشكلة وتقول إنك قرأت الدليل فعلاً، لتوضح أنك لا تسأل عشوائياً.
والمعنى الأول، مهما كان مضحكاً بين القدماء، سيئ في فريق حديث. فالمبرمج الجديد الذي يتلقى RTFM على سؤاله الأول سوف يتوقف عن السؤال، وسوف يقضي ساعات في مشكلة كان زميله سيحلها في دقيقة. والأفضل أن ترد برابط الصفحة المحددة في التوثيق، فتحقق نفس الهدف، أي تعليمه أين يجد الإجابة، دون أن تهينه. أما المعنى الثاني فعادة ممتازة: عندما تسأل، قل ما الذي قرأته وجربته قبل السؤال.
كلمات مراجعة الكود Code Review
يوم الخميس، أرسل خالد طلب الدمج Pull Request الأول له بإصلاح الحجز المزدوج. وبعد ساعة وصلته المراجعة: ثلاثة تعليقات تبدأ بكلمة Nit، وفي النهاية LGTM.
موافقة المراجع LGTM
LGTM اختصار Looks Good To Me، أي «يبدو جيداً بالنسبة لي»، وهو أشهر موافقة في مراجعة الكود. ولهذه الكلمة معنى رسمي في بعض المشاريع، ففي توثيق مراجعة الكود في مشروع Chromium يعطي المراجع الموافقة بعلامة Code-Review +1 في نظام Gerrit، ويقول التوثيق إن هذه العلامة تعرف أيضاً باسم LGTM. أي أن الكلمة التي بدأت تعليقاً عابراً صارت اسماً لحالة في أداة.
ولكن احذر من شيء يعرفه كل من عمل في فريق كبير: LGTM التي تكتب دون قراءة حقيقية. فالمراجعة التي تكتفي بالموافقة لأن الكاتب زميل موثوق، أو لأن التغيير كبير ولا وقت لقراءته، هي أخطر من عدم المراجعة، لأنها تعطي شعوراً كاذباً بالأمان. وقد كتبنا عن هذا الخطر بالتفصيل في مقال مراجعة كود الذكاء الاصطناعي دون أن تصبح شكلية.
الملاحظة الصغيرة Nit
أما Nit فمن Nitpick، أي التدقيق في التفاصيل الصغيرة جداً. وتشرح ممارسات Google الهندسية في كتابة تعليقات المراجعة فائدتها بوضوح: يفضل أن تحدد درجة كل تعليق، لتفرق بين التغييرات المطلوبة والإرشادات والاقتراحات. وتقترح ثلاث تسميات: Nit لشيء صغير يفضل أن يعدل ولكنه لن يؤثر كثيراً، وOptional أو Consider لفكرة جيدة ولكنها غير مطلوبة، وFYI لشيء لا يتوقع المراجع أن يعدل في هذا التغيير ولكنه يستحق التفكير مستقبلاً.

وهذه عادة بسيطة تغير جو المراجعة كله. فالمبرمج الجديد الذي يرى عشرين تعليقاً على أول طلب دمج له قد يشعر أن عمله سيئ، بينما هي في الحقيقة ثلاث ملاحظات مهمة وسبعة عشر Nit. وعندما تسمي درجة كل تعليق، يعرف ما الذي يجب أن يعدله قبل الدمج، وما الذي يستطيع أن يتركه لمرة قادمة.
كلمات إدارة المشروع Project Management
يوم الخميس مساءً، اجتماع قصير مع مدير المنتج قبل نهاية الأسبوع. والأسئلة هذه المرة ليست عن الكود، وإنما عن الفريق والمنتج.
الدين التقني Technical Debt
سأل مدير المنتج: لماذا يأخذ كل تغيير صغير في نظام الحجز أسبوعاً؟ فقالت سارة: لأن عندنا دين تقني كبير في هذا الجزء. وهذه الاستعارة لها أب معروف وتاريخ محدد. ففي تقرير تجربة قدمه Ward Cunningham في مؤتمر OOPSLA سنة 1992 عن نظام إدارة المحافظ المالية WyCash، كتب أن نشر الكود لأول مرة يشبه الاقتراض، وأن قليلاً من الدين يسرع التطوير بشرط أن يسدد بسرعة بإعادة كتابة، وأن كل دقيقة تقضى على كود ليس صحيحاً تماماً تحسب فائدة على هذا الدين، وأن الدين الذي لا يسدد قد يوقف قسماً هندسياً كاملاً عن العمل.

ولاحظ ما يقوله Cunningham فعلاً، لأن كثيرين يستخدمون الكلمة بمعنى «الكود السيئ» فقط. فالاستعارة عنده ليست عن الكود السيئ، وإنما عن قرار واع: أن تنشر شيئاً قبل أن تفهم المشكلة تماماً، لتتعلم من المستخدمين، ثم تعيد كتابته عندما تفهم. والدين في هذا المعنى أداة مفيدة، مثل القرض الذي يسمح لك بشراء بيت قبل أن تجمع ثمنه. والمشكلة ليست في الاقتراض، وإنما في الفوائد التي تتراكم عندما لا تسدد. وفي قصة فريقنا، الأسبوع الذي يأخذه كل تغيير هو الفائدة، وإعادة كتابة نظام الحجز هي السداد.
عامل الحافلة Bus Factor
ثم سأل مدير المنتج سؤالاً آخر: ماذا لو غاب أحمد، المبرمج الذي كتب نظام الإشعارات وحده؟ ولم يعرف أحد الإجابة. وهذا ما يسمى Bus Factor أو Truck Factor، أي عامل الحافلة أو الشاحنة، والاسم قاس عمداً: كم شخصاً في فريقك يجب أن تصدمهم حافلة، أو بلغة ألطف أن يتركوا العمل، قبل أن يتوقف المشروع؟
ولهذا السؤال دراسة علمية معروفة. ففي ورقة A Novel Approach for Estimating Truck Factors سنة 2016، يعرف الباحثون Guilherme Avelino وزملاؤه عامل الشاحنة بأنه أقل عدد من المطورين يجب أن «تصدمهم شاحنة» أو يتركوا المشروع قبل أن يعجز المشروع عن الاستمرار. وطبقوا طريقتهم على 133 مشروعاً شهيراً على GitHub، ووجدوا أن 65% منها عامل الشاحنة فيها اثنان أو أقل. أي أن أغلب المشاريع الشهيرة تعتمد فعلياً على شخص أو شخصين.
وفي فريق صغير مثل فريقنا، عامل الحافلة في نظام الإشعارات واحد. والعلاج ليس في توظيف أشخاص أكثر، وإنما في نقل المعرفة: أن يراجع شخص آخر كل تغيير في هذا الجزء، وأن يعمل اثنان معاً على المهمة التالية فيه، وأن يكتب أحمد صفحة واحدة تشرح كيف يعمل النظام. وقد ناقشنا في مقال هل يسلم الفريق الأكبر أسرع؟ قانون Brooks لماذا لا يحل إضافة الأشخاص مشكلة المعرفة بسرعة.
أكل طعام الكلاب Dogfooding
واقترحت سارة شيئاً: أن يستخدم الفريق نفسه التطبيق لحجز مواعيده الشخصية في العيادات الشريكة لمدة شهر. وهذا ما يسمى Dogfooding، من تعبير «أن تأكل طعام كلابك». ويعرفه Jargon File بأنه برمجيات مؤقتة تستخدم داخلياً للاختبار، ويذكر أن الكلمة من ثقافة Microsoft وNetscape، وأن «أن تأكل طعام كلابك» يعني أن تستخدم البرنامج الذي تطوره كجزء من بيئة عملك اليومية. والفكرة، كما يقول الملف، أن المطورين الذين يستخدمون برنامجهم سوف يكتشفون بسرعة ما ينقصه وما هو معطل.
ويضيف الملف ملاحظة طريفة عن المصادر المفتوحة: الممارسة طبيعية في مجتمع Linux، ولكن الكلمة نادرة هناك، لأن النسخ التجريبية في المشاريع المفتوحة «لذيذة ومغذية» في العادة. وبعيداً عن المزاح، فالـ Dogfooding من أرخص طرق الاختبار وأكثرها صدقاً، لأن المطور الذي يعاني من خطأ في برنامجه يصلحه أسرع من أي تذكرة في نظام البلاغات.
النشر Ship: الفنانون الحقيقيون ينشرون
وفي آخر الاجتماع سأل مدير المنتج: متى ننشر الإصلاح؟ وكلمة Ship، أي أن تشحن المنتج إلى العملاء، صارت في لغة المبرمجين تعني أن تنشر التغيير فعلاً ويصل إلى المستخدمين. ولها في ثقافة الصناعة جملة شهيرة: Real Artists Ship، أي «الفنانون الحقيقيون ينشرون». ويروي Andy Hertzfeld، أحد أعضاء فريق Macintosh الأول، في قصة بهذا العنوان كيف كان الفريق في يناير 1984 متعباً ومتأخراً عن الموعد قبل أيام من الإعلان عن الجهاز، فاقترح أحدهم أن يرسلوا نسخة تجريبية إلى الموزعين ثم النسخة النهائية بعد أسابيع، فرفض Steve Jobs أي تأخير قائلاً إنه لا مجال للتأخر، وطلب منهم أن ينهوا البرنامج بأفضل ما يستطيعون، ثم اتفقوا على مهلة حتى السادسة صباح الاثنين.
والدرس في الجملة ليس أن تنشر أي شيء بأي ثمن، وإنما أن العمل الذي لا يصل إلى المستخدم لا قيمة له مهما كان جميلاً. ولكن ضعه بجانب درس Cunningham: أن تنشر بسرعة يعني أن تقترض، والقرض يحتاج خطة سداد.
كيف تستخدم هذه الكلمات في فريق عربي؟ قاموس الفريق Team Glossary
في أغلب الفرق العربية تسمع هذه الكلمات بالإنجليزية كما هي، وهذا في رأيي صحيح، لأن ترجمتها تفقدها نصف معناها. فـ «حلاقة الثور» بالعربية تبدو غريبة، و«لون مظلة الدراجات» يحتاج شرحاً أطول من الكلمة نفسها. ولكن هناك خطراً حقيقياً: أن تتحول هذه الكلمات إلى لغة سرية تفصل القدماء عن الجدد، وأن يشعر خالد في أسبوعه الأول أن الجميع يتكلم لغة لا يعرفها.
وهذه قواعد عملية تقلل هذا الخطر:
| الكلمة | متى تقولها | ما الذي تقوله معها للجديد |
|---|---|---|
| Bikeshedding | عندما يطول النقاش في تفصيل صغير | «لنضع خمس دقائق لهذا القرار ونرجع للبند الأهم» |
| Yak Shaving | عندما تأخذك مهمة إلى سلسلة مهام تحضيرية | «هل هناك طريق أقصر، أو شخص مر بهذا قبلك؟» |
| Rabbit Hole | عندما يبتعد البحث عن الهدف | «سجل السؤال في ملاحظة ونرجع له بعد التسليم» |
| Nit | في تعليق مراجعة غير مطلوب | «يمكنك تجاهله إذا لم يكن عندك وقت» |
| LGTM | عندما توافق فعلاً بعد القراءة | اذكر ما الذي راجعته، لا الكلمة وحدها |
| Technical Debt | عند تقدير وقت التغيير أمام الإدارة | «هذا الجزء يأخذ وقتاً لأن فيه دين لم نسدده، وهذه خطة السداد» |
| Bus Factor | عند مراجعة المخاطر أو قبل إجازة طويلة | «من غيرك يعرف كيف يعمل هذا؟» |
| RTFM | لا تقلها لزميل | أرسل رابط الصفحة المحددة في التوثيق بدلاً منها |
وفكرة أخيرة: اجعل في توثيق الفريق صفحة صغيرة لهذه الكلمات، مثل هذا المقال ولكن مختصرة، ترسلها لكل من ينضم في أسبوعه الأول. فهي توفر عليه بحثاً طويلاً، وتخبره أن الفريق يرحب بأسئلته، وتفعل ما فعله Jargon File للمبرمجين قبل خمسين سنة: تحول اللغة الداخلية إلى شيء يمكن أن يتعلمه أي شخص.
ماذا نتعلم من هذه الكلمات؟ قائمة Checklist لفريقك
إذا نظرت إلى الكلمات الثماني عشرة معاً، فسوف تجد أن أغلبها ليس عن الكود، وإنما عن الناس: كيف نتناقش، وكيف نراجع، وكيف نوزع المعرفة، وكيف نتخذ القرار. وهذه أسئلة يستحق أن يسألها فريقك مرة كل شهر:
- هل في الكود أرقام سحرية Magic Numbers أو أسماء مثل foo خارج الأمثلة؟ كل رقم بلا اسم سؤال سيسأله أحد يوماً.
- هل عندنا سطور Cargo Cult لا يعرف أحد سببها؟ سجل لكل واحد منها سؤالاً، أو جربه في بيئة اختبار.
- عندما يختفي الخطأ بعد تغيير عشوائي، هل نعرف لماذا اختفى؟ إذا لم نعرف، فهو لم يختف، وإنما اختبأ.
- هل اجتماعاتنا تقضي وقتاً أطول في القرارات الصغيرة من الكبيرة؟ هذا هو Bikeshedding، وعلاجه وقت محدد ومعارض محدد.
- هل تعليقات المراجعة مصنفة بدرجتها؟ Nit وOptional وFYI توفر الكثير من سوء الفهم.
- هل كل LGTM عندنا جاءت بعد قراءة حقيقية؟ المراجعة الشكلية أخطر من عدم المراجعة.
- ما عامل الحافلة في كل خدمة؟ إذا كان واحداً، فالخطوة التالية في تلك الخدمة يجب أن يعمل عليها شخصان.
- هل عندنا خطة لسداد الدين التقني، أم أننا نقترض فقط؟
- هل يستخدم الفريق منتجه بنفسه؟ لا شيء يكشف الأخطاء مثل أن يعاني منها من يكتب الكود.
- هل يجد المبرمج الجديد صفحة تشرح لغة الفريق؟ أم يتعلمها من الإحراج؟
الخلاصة Summary
- foo وbar أسماء وهمية لها وثيقة رسمية هي RFC 3092 سنة 2001، وأصلها في قصص Smokey Stover المصورة في الثلاثينيات وفي نادي TMRC في MIT.
- Magic Number رقم بلا اسم في الكود، وSpaghetti Code كود متشابك المسارات، وKludge حل مرقع قد يعمل للسبب الخطأ، وCargo Cult Programming كود طقوسي لا يعرف أحد سببه، والاسم من خطاب Feynman سنة 1974.
- فراشة Harvard Mark II في 9 سبتمبر 1947 لم تخترع كلمة Bug، فالسجل نفسه يقول إنها «أول حالة فعلية».
- Heisenbug خطأ يختفي عندما تفحصه، وRubber Duck طريقة لشرح الكود بصوت عال من كتاب The Pragmatic Programmer، وShotgun Debugging تغييرات عشوائية لا تنجح تقريباً أبداً، وRabbit Hole من رواية Alice.
- Bikeshedding من رسالة Poul-Henning Kamp لمطوري FreeBSD في 2 أكتوبر 1999 ومثال Parkinson، وYak Shaving من MIT بعد 2000، وRTFM من ثقافة Unix.
- LGTM في Chromium تساوي Code-Review +1، وNit تسمية لملاحظة صغيرة في ممارسات Google الهندسية.
- Technical Debt استعارة Ward Cunningham سنة 1992، وBus Factor سؤال علمي وجدت دراسة عنه أن 65% من 133 مشروعاً شهيراً يعتمد على شخصين أو أقل، وDogfooding من Microsoft وNetscape، وReal Artists Ship من فريق Macintosh في يناير 1984.
وإذا أعجبتك هذه القصة فاقرأ معها المهندس الشامل لقصة كلمة Hacker ونادي TMRC، وقراءة رسالة الخطأ والتصحيح Debugging لما بعد البطة المطاطية، وما هي جودة الكود وكيف تقيسها لقياس ما تسميه هذه الكلمات، وقصة Windows NT وDave Cutler لترى فريقاً عاش كثيراً من هذه الكلمات قبل أن تكون لها أسماء.
سجل التحديثات Changelog
- أكتوبر 2026: كتابة المقال من مصادر كل كلمة: Jargon File، وRFC 3092، ورسالة Poul-Henning Kamp وسؤال FreeBSD FAQ، وخطاب Feynman، وتقرير Ward Cunningham، ودراسة عامل الشاحنة، وتوثيق Chromium وممارسات Google الهندسية، وقصة Andy Hertzfeld.