مطوّر يدفع 150 يورو لمتطوعين يتبعون ملف README أمامه، فيكتشف أنه لم يشرح ما يفعله البرنامج

نشر المطوّر Terence Eden في 11 أكتوبر 2026 تجربة أجراها على ملف README لمشروعه ActivityBot، ضمن طلب منحة من مؤسسة NLnet. نشر دعوة على Mastodon، وعرض 25 يورو مقابل ساعة من وقت كل متطوع، ودفع في المجموع نحو 150 يورو. وطلب من كل شخص أن يشارك شاشته، وأن يتكلم بصوت عالٍ وهو يتبع خطوات الملف.

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

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

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

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