# Michael Lynch يرصد أخطاء التدوين التقني: العنوان وأول ثلاث جمل تحسم بقاء القارئ

> **المغزى:** المغزى: النص التقني يخسر قارئه غالبًا قبل أن يبدأ، بالتمهيد الطويل أو بافتراض معرفة لا يملكها، وفحص المسودة بعين شخص حقيقي أداة مجانية تنفع في التوثيق ووصف الـ pull request أيضًا.

- المصدر: المغزى (https://almaghza.com/a/2026-10-08-michael-lynch-blogging-anti-patterns/)
- التاريخ: 27 ربيع الآخر - 8 أكتوبر 2026 (2026-10-08)
- القسم: فرق ومنتجات
- الوسوم: الكتابة، التوثيق

نشر المطوّر والكاتب Michael Lynch، في 7 أكتوبر 2026، مقالًا بعنوان أنماط خاطئة في التدوين التقني، ضمن موقع كتابه Refactoring English. وأكثر خطأ يتوقف عنده ليس لغويًا، بل هو المقدمة الطويلة التي لا تصل إلى الموضوع.

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

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

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

ومن الأنماط التي يسميها أيضًا افتراض أن القارئ يعرف كل ما يعرفه الكاتب إلا نقطة واحدة. ومثاله على ذلك من يشرح Docker لمبتدئ بأنه واجهة أنيقة فوق cgroups في Linux. فمن يقرأ مقدمة عن Docker لا يعرف غالبًا ما هي cgroups، وقد لا يعرف Linux نفسه.

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

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

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

## المصادر

- [المقال الأصلي: Anti-patterns in software blogging](https://refactoringenglish.com/blog/anti-patterns-software-blogging/)
- [كتاب Refactoring English الذي خرج منه المقال](https://refactoringenglish.com)
- [مقال للكاتب استشهد به مثالًا على مقدمة مباشرة](https://mtlynch.io/if-got-want/)