المهارات المهنية للتقنيين الأدلة التقنية

ثقافة الكتابة في الفريق Writing Culture: RFC وADR

كيف يكتب الفريق الفكرة قبل أن يناقشها، ومتى يكتب طلب نقاش أو سجل قرار، ومتى يكون الاجتماع أفضل من الوثيقة.

ثقافة الكتابة في الفريق Writing Culture: RFC وADR

إذا كان فريقك يعقد اجتماعاً Meeting لكل قرار صغير، ثم يختلف بعد أسبوعين على ما اتفق عليه في ذلك الاجتماع، فهذا المقال لك. وهو أيضاً لمن انضم إلى فريق جديد ووجد أن المعرفة كلها في رؤوس شخصين، ولمن يسأل كل شهر نفس السؤال «لماذا اخترنا هذه التقنية؟» ولا يجد من يجيب.

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

سوف نناقش في هذا المقال:

  • لماذا تختار فرق معروفة مثل Amazon وGitLab وOxide الكتابة قبل الاجتماع، وماذا تقول مصادرها المنشورة.
  • خريطة المستندات Documents التي يحتاجها فريق تقني، ومتى تكتب كل واحدة منها.
  • ما هو طلب النقاش RFC وما هو سجل القرار ADR باختصار، مع روابط للمقالات التي تشرح كلاً منهما بالتفصيل.
  • متى يكون الاجتماع أفضل من الوثيقة، بجدول قرار واضح.
  • خطوات لبدء ثقافة الكتابة في فريق صغير، وكيف تعلق على وثيقة زميلك، والأخطاء التي تحول الكتابة إلى بيروقراطية.

باختصار Quick Summary

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

ما هي ثقافة الكتابة Writing Culture؟

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

وتصف GitLab هذا الفرق بوضوح في دليلها المنشور، فتقول إن كلمة «التوثيق» Documentation تعني عادة كتابة الشيء بعد أن يعلن عنه، وهي خطوة يتركها الناس كثيراً. أما عندهم فالترتيب معكوس: يكتبون الحل أولاً في الدليل Handbook، ثم يعلنون عنه في المحادثة أو البريد مع رابط إليه. وتسمي هذا الأسلوب «الدليل أولاً» Handbook-first.

والكلمة المهمة هنا هي «أولاً». فالفريق الذي يكتب محضراً Minutes بعد كل اجتماع ما زال فريقاً يقرر شفهياً ثم يوثق. وهذا أفضل من لا شيء، لكنه لا يعطيك أهم فائدة للكتابة، وهي أن الكاتب يفكر وهو يكتب، فيكتشف الثغرات في فكرته قبل أن يراها غيره.

وثقافة الكتابة لا تعني أيضاً إلغاء الكلام. الفرق التي تكتب كثيراً تجتمع أيضاً، لكنها تجتمع لتحسم خلافاً واضحاً على وثيقة قرأها الجميع، وليس لتسمع الفكرة أول مرة.

المصدر: GitLab Handbook، صفحة The importance of a handbook-first approach to communication.

لماذا الكتابة قبل الاجتماع؟ Why Write First

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

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

الكتابة تكشف الفكرة الناقصة Clarity

في الكلام تستطيع أن تقفز فوق الجزء الذي لم تفكر فيه، وتملأه بنبرة واثقة. أما على الورق فالجملة الناقصة تبقى ناقصة أمامك. لذلك يكتشف كثير من المهندسين وهم يكتبون فقرة «الخيارات الأخرى» أن الخيار الذي رفضوه في رؤوسهم أفضل مما ظنوا، أو أن المشكلة نفسها أصغر مما توقعوا.

الكتابة تحترم وقت الفريق وتركيزه Focus

القارئ يقرأ الوثيقة في الوقت الذي يناسبه، وليس في الساعة التي اختارها المنظم. وهذا مهم للمبرمج الذي يحتاج ساعات متصلة دون مقاطعة، وشرحنا لماذا في مقال التركيز العميق Deep Work. وهو أهم للفرق الموزعة على أكثر من منطقة زمنية Time Zone، حيث لا توجد ساعة يناسب فيها الاجتماع الجميع.

الكتابة تبقى بعد أن ينسى الناس Memory

بعد ستة أشهر لن يتذكر أحد لماذا اخترتم قاعدة البيانات Database هذه. وإذا لم يكن السبب مكتوباً فسيحدث أحد أمرين ذكرهما Michael Nygard في مقاله عن سجلات القرار عام 2011: إما أن يقبل المهندس الجديد القرار كما هو دون أن يفهمه، فلا يستطيع تغييره حين يجب أن يتغير، وإما أن يغيره دون أن يفهم سببه، فيعيد مشكلة حلها الفريق من قبل.

الكتابة تعطي صوتاً لمن لا يتكلم في الاجتماع Inclusion

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

الكتابة تكبر مع الفريق Scale

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

الكتابة تجعل عملك مرئياً Visibility

الوثيقة التي كتبتها وغيرت قراراً مهماً تبقى باسمك، ويقرؤها من لم يحضر. وهذا من أهم ما يجعل عمل المهندس مرئياً Visible لمن يقيمه، وهو موضوع مرحلة كاملة في هذا المسار عن السجل اليومي وملف الإنجازات.

ماذا تقول الفرق التي جربت هذا؟ Real Practices

الأفكار السابقة ليست نظرية، فقد كتبت عنها فرق كبيرة ومشاريع مفتوحة المصدر Open Source في مصادر منشورة نستطيع أن نقرأها. والجدول التالي يجمع أهمها:

الجهةالممارسةما نأخذه منهاالمصدر
Amazonمذكرة سردية من ست صفحات Six-page Memo بدل الشرائح، تقرأ بصمت في أول الاجتماعالقراءة داخل الاجتماع تضمن أن الجميع قرأرسالة المساهمين 2017
GitLabالدليل أولاً Handbook-first، والمحادثة تحذف بعد 90 يوماًاكتب ثم أعلن، ولا تجعل المحادثة مرجعاًGitLab Handbook
Googleوثيقة التصميم Design Doc قبل البرمجة للمشكلات التي فيها خياراتلا تكتب وثيقة لمشكلة حلها واضحMalte Ubl، 2020
Oxide Computerطلب النقاش RFD بحالات واضحة من الفكرة إلى التنفيذاكتب مبكراً، ولا تنتظر أن تكتمل الفكرةRFD 1
مشروع Rustطلب النقاش RFC مفتوح مع فترة تعليقات أخيرةموعد معروف ينتهي عنده النقاشمستودع rust-lang/rfcs
Michael Nygardسجل القرار المعماري ADR من صفحة أو صفحتينسجل القرار وسببه ونتائجه، لا التصميم كلهمقاله عام 2011

مذكرة Amazon والقراءة الصامتة Silent Reading

كتب Jeff Bezos في رسالته إلى المساهمين لعام 2017 أن Amazon لا تستخدم العروض بالشرائح PowerPoint، وإنما تكتب مذكرات سردية Narrative Memos من ست صفحات. ويقرأ الحاضرون المذكرة بصمت في أول الاجتماع، ويصف ذلك بأنه نوع من «قاعة الدراسة» Study Hall.

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

والدرس لفريقك: الوثيقة التي تغير قراراً تحتاج وقتاً حقيقياً، فخطط له كما تخطط لمهمة برمجية. ولا تطلب من زميل وثيقة جيدة «للاجتماع غداً».

GitLab: المحادثة ليست مرجعاً

تذكر GitLab في صفحة «الدليل أولاً» أنها تحتفظ بسجل Slack تسعين يوماً فقط، ثم يحذف. والسبب الذي تذكره أن الناس إذا عرفوا أنهم يستطيعون البحث في المحادثة القديمة فلن يكتبوا القرار في مكان يصل إليه الجميع. فالحذف عندهم أداة تجبر الفريق على نقل المعرفة إلى المرجع الواحد Single Source of Truth.

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

من أين جاء اسم RFC؟

اسم «طلب التعليقات» Request for Comments قديم، فقد بدأ مع مهندسي شبكة ARPANET عام 1969. وفي الوثيقة RFC 3 التي كتبها Steve Crocker في أبريل 1969 جملة ما زالت تصلح قاعدة لكل فريق: الملاحظات يفضل أن تكون في وقتها وليست مصقولة، أي «timely rather than polished». وما زالت Oxide تقتبس هذه الجملة في وثيقتها RFD 1.

والمعنى العملي: لا تنتظر أن تكتمل فكرتك لتكتبها. اكتبها وهي نصف جاهزة، وقل ذلك في أولها، ودع الفريق يكملها معك.

خريطة المستندات Document Map: أي وثيقة لأي موقف؟

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

خريطة المستندات في الفريق التقني موزعة على ثلاث مراحل: قبل القرار طلب النقاش RFC ووثيقة التصميم Design Doc ومقترح الصفحة الواحدة One-pager، وعند القرار سجل القرار ADR ومحضر الاجتماع، وبعد التنفيذ ملف README ودليل التشغيل Runbook وتقرير ما بعد الحادثة Postmortem والتحديث الأسبوعي
كل موقف له مستند واحد: قبل القرار، وعنده، وبعد التنفيذ
الموقفالمستندالطول المعتادمن يكتبه
فكرة تريد أن تعرف هل تستحق العملمقترح صفحة واحدة One-pagerصفحةصاحب الفكرة
قرار كبير فيه أكثر من خيار ويمس أكثر من فريقطلب النقاش RFC أو وثيقة التصميم Design Docمن 2 إلى 10 صفحاتالمهندس الذي سينفذ غالباً
قرار اتخذ ويجب أن يبقى سببهسجل القرار ADRصفحة أو صفحتانصاحب القرار
اجتماع انتهى بقرارات ومهاممحضر الاجتماع Meeting Notesنصف صفحةشخص يحدد قبل الاجتماع
خدمة أو مستودع Repository يستخدمه غيركملف READMEصفحة أو صفحتانالفريق المالك
إجراء يتكرر أو ينفذ عند عطلدليل التشغيل Runbookحسب الإجراءمن يعرف الإجراء أكثر
حادثة أثرت على العملاءتقرير ما بعد الحادثة Postmortemمن 2 إلى 5 صفحاتقائد الحادثة مع الفريق
تقدم العمل لمن يتابعهالتحديث الأسبوعي Status Updateمن 3 إلى 10 أسطرصاحب العمل

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

وكل مستند في الجدول له مقال يشرحه بالتفصيل في الموقع أو في هذا المسار. فكتابة ملف README ودليل التشغيل ووثيقة التصميم لها مقال مستقل في نفس المرحلة، وكذلك رسائل العمل اليومية، وتجد دليل التشغيل Runbook ومراجعة الحادثة دون لوم Blameless Postmortem في مسارات أخرى.

طلب النقاش RFC باختصار

طلب النقاش RFC وثيقة يكتبها صاحب فكرة قبل قرار كبير، ويطلب فيها تعليق الفريق في مدة محددة. ويسمى في Google «وثيقة التصميم» Design Doc، وفي Oxide «طلب النقاش» Request for Discussion واختصاراً RFD، والفكرة واحدة.

وأهم ما يميز طلب النقاش الجيد ثلاثة أشياء:

  1. مشكلة قبل الحل: يبدأ بما يحدث اليوم ولماذا يجب أن يتغير الآن، بأرقام إن وجدت، قبل أن يقول ما الحل.
  2. خيارات حقيقية: يذكر خيارين أو ثلاثة جديرة بالنقاش، ولماذا رفض كل واحد، وليس خياراً واحداً وأمامه خيارات ضعيفة وضعت للشكل.
  3. موعد وقرار: يقول من يقرر، ومتى ينتهي التعليق. ففي مشروع Rust مثلاً تبدأ «فترة التعليقات الأخيرة» Final Comment Period بعد موافقة الفريق المختص، ثم يدمج الطلب أو يغلق.

ولكل طلب نقاش حالة يعرفها القارئ من النظرة الأولى. والشكل التالي يبين الحالات كما تكتبها Oxide في وثيقة RFD 1:

حالات الوثيقة عند Oxide بالترتيب: قبل النقاش Prediscussion مسودة غير جاهزة، ثم الفكرة Ideation تحدد النطاق فقط، ثم النقاش Discussion في طلب دمج مفتوح، ثم منشورة Published بعد أن يتفق النقاش، ثم منفذة Committed بعد التنفيذ الكامل، وقد تصبح متروكة Abandoned إذا ثبت أن الفكرة غير مناسبة
حالات الوثيقة في Oxide: كل قارئ يعرف هل الوثيقة مفتوحة للنقاش أم حسمت

أما القالب الكامل لوثيقة التصميم، وكيف تدير مراجعة التصميم Design Review قبل الاجتماع وأثناءه وبعده، فشرحناه خطوة خطوة في مقال القرار التقني في الفريق، فلا نعيده هنا.

المصدر: Oxide RFD 1: Requests for Discussion، ومستودع rust-lang/rfcs، وDesign Docs at Google لـ Malte Ubl (2020).

سجل القرار ADR باختصار

سجل القرار المعماري Architecture Decision Record واختصاراً ADR صفحة قصيرة تكتب بعد القرار وليس قبله. ولا تشرح التصميم كله، وإنما قراراً واحداً: ما هو، ولماذا اتخذ، وما نتائجه. واقترح Michael Nygard هذه الفكرة في مقاله عام 2011 بخمسة أقسام، وقال إن الوثيقة كلها يجب أن تكون صفحة أو صفحتين.

ويبين الجدول التالي الأقسام الخمسة مع مثال افتراضي لفريق يقرر طريقة إرسال الإشعارات Notifications:

القسمماذا تكتبمثال افتراضي
العنوان Titleعبارة اسمية قصيرة برقم متسلسلADR 7: إرسال الإشعارات عبر طابور رسائل Message Queue
السياق Contextالظروف التي فرضت القرار، بلغة محايدةالإشعارات ترسل اليوم من داخل الطلب، وعندما يتأخر مزود الرسائل يتأخر الطلب كله
القرار Decisionما قررناه، بصيغة «سوف نفعل»سوف نضع كل إشعار في طابور، وترسله خدمة منفصلة
الحالة Statusمقترح، أو مقبول، أو ملغى، أو استبدل بقرار آخرمقبول
النتائج Consequencesكل النتائج، الجيدة والسيئة والمحايدةالطلب لا ينتظر المزود، ولكن نحتاج مراقبة الطابور، والإشعار قد يصل بعد ثوان

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

وأين تحفظ هذه السجلات، وما الأدوات التي تساعدك، وقالب MADR الذي يضيف الخيارات المرفوضة، كل ذلك في مقال توثيق المعمارية بمخططات C4 وADR.

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

كتابة أم اجتماع؟ جدول القرار Decision Table

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

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

ومن القواعد المفيدة في هذا الجدول قاعدة «الجولتين». فإذا تبادلت أنت وزميلك ردين أو ثلاثة على نفس النقطة في التعليقات دون تقدم، فتوقف عن الكتابة واطلب مكالمة من خمس عشرة دقيقة، ثم اكتب نتيجتها في الوثيقة. والسبب أن الخلاف المكتوب يتحول بسرعة إلى مباراة في الردود، وكل طرف يقرأ في كلام الآخر نبرة لم يقصدها.

وفي الحالات التي يكون فيها الاجتماع هو الأفضل، لا تنس أن ثقافة الكتابة تعود بعده: سطران بالقرار، ومن ينفذ، ومتى. وتقول GitLab في دليل الاجتماعات إن الاجتماع الذي ليس له جدول أعمال Agenda مشكلة، وإن الاجتماع الذي له جدولان مشكلة أيضاً، وإن الاجتماع وملاحظاته يحتاجان مرجعاً واحداً.

المصدر: GitLab Handbook، All-Remote Meetings.

قبل وبعد: قرار في المحادثة وقرار مكتوب Before and After

لنأخذ مثالاً افتراضياً يحدث في أغلب الفرق. نقاش في قناة المحادثة Chat Channel عن الحد الأقصى لحجم الملفات التي يرفعها المستخدم:

قبل: ما بقي في المحادثةبعد: ما كتب في سجل القرار
«خلاص نخليها 10 ميجا؟» ثم «تمام» ثم «بس الفيديو؟» ثم «نشوف بعدين» ثم 40 رسالة عن موضوع آخرADR 12: حد رفع الملفات 10 MB للصور والمستندات. السياق: 3 أعطال في الشهر الماضي سببها ملفات كبيرة ملأت الذاكرة. القرار: الحد 10 MB، والفيديو خارج النطاق الآن. الحالة: مقبول. النتائج: بعض العملاء سيرون رسالة رفض، وفريق الدعم أبلغ بها. يراجع عند طلب دعم الفيديو.

لاحظ ما تغير. القرار المكتوب يقول ما اتفقنا عليه، ولماذا، وما تركناه عمداً (الفيديو)، ومن تأثر (الدعم)، ومتى نعود إليه. والمهندس الذي ينضم بعد سنة ويسأل «لماذا 10 MB بالذات؟» يجد الجواب في دقيقة، بدل أن يبحث في مئات الرسائل أو يسأل من غادر الشركة.

ومثال آخر من الاجتماعات. هذا محضر يكتبه كثيرون، ثم المحضر الذي يفيد:

قبلبعد
«ناقشنا موضوع الأداء وتم الاتفاق على تحسينه، وتحدثنا عن الإطلاق»القرارات: نؤجل الإطلاق أسبوعاً حتى يصبح زمن الاستجابة Latency أقل من ثانية في الصفحة الرئيسية.
المهام: قياس الصفحات الخمس الأبطأ (صاحب المهمة محدد، الخميس).
أسئلة مفتوحة: هل نبلغ العميل بالتأجيل الآن أم بعد القياس؟ يقرر مدير المنتج غداً.

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

كيف تبدأ ثقافة الكتابة في فريقك؟ ثماني خطوات Steps

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

الخطوة 1: اختر مكاناً واحداً للوثائق Single Source of Truth

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

الوقت: اجتماع واحد قصير. التكلفة: لا شيء غالباً، فأغلب الفرق تملك أداة مناسبة.

الخطوة 2: ابدأ بنوع واحد من المستندات Start Small

لا تطلب طلبات نقاش وسجلات قرار ومحاضر وأدلة تشغيل في نفس الشهر. اختر نوعاً واحداً يحل ألماً يشعر به الفريق الآن. وأغلب الفرق تبدأ بسجل القرار ADR لأنه قصير، ولأن سؤال «لماذا اخترنا هذا؟» مؤلم في كل فريق.

الخطوة 3: ضع قالباً قصيراً Template

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

الخطوة 4: اكتب أنت أول ثلاث وثائق Lead by Example

إذا كنت قائد الفريق Team Lead أو مهندساً أول Senior Engineer فابدأ بنفسك. اكتب أول ثلاث وثائق، واجعلها قصيرة وواضحة، وأرسلها مع طلب صريح للتعليق. والفريق يتعلم من المثال أكثر مما يتعلم من القاعدة.

الخطوة 5: حدد موعداً ينتهي عنده التعليق Comment Deadline

الوثيقة المفتوحة للتعليق إلى الأبد لا تنتهي بقرار. اكتب في أعلاها: «التعليقات حتى الأربعاء، والقرار يوم الخميس، ويقرر فلان». والموعد يعطي القارئ سبباً ليقرأ الآن، ويعطي الكاتب حقاً في أن يقرر بعده.

الخطوة 6: اجعل الاجتماع يبدأ بالوثيقة Read First

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

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

الخطوة 8: راجع بعد ثلاثة أشهر Quarterly Review

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

كيف تعلق على وثيقة زميلك؟ Document Review

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

نوع التعليقمعناهمثال
مانع Blockingلا أوافق على القرار حتى يحل هذا«مانع: الخطة لا تذكر كيف نرجع إذا فشل الترحيل Migration في منتصفه»
سؤال Questionلم أفهم، وقد يكون الجواب بسيطاً«سؤال: هل الرقم 2,000 طلب في الدقيقة من أعلى يوم أم من المتوسط؟»
اقتراح Suggestionفكرة قد تحسن الحل، والقرار لك«اقتراح: يمكن أن نبدأ بالعملاء الداخليين أسبوعاً قبل الجميع»
صياغة Nitتفصيل صغير في اللغة أو الشكل«صياغة: الجدول الثاني يكرر الأول، يمكن حذفه»

وهذه أمثلة لتعليقات تضر، وما تكتبه بدلها:

قبلبعد
«هذا لن ينجح»«مانع: أخشى أن الحل لا يتحمل ضعف الطلبات في موسم العروض. هل جربناه على رقم قريب من ذلك؟»
«لماذا لم تستخدم X؟»«سؤال: هل نظرنا في X؟ أظنه يحل مشكلة التكرار. إذا رفض لسبب أضفه إلى قسم الخيارات الأخرى»
«الوثيقة طويلة جداً»«اقتراح: القسم 3 و4 يمكن أن يدمجا، والملحق يمكن أن ينقل إلى رابط»
تعليق في المحادثة الخاصة عن الوثيقةتعليق على الوثيقة نفسها، حتى يراه الجميع ويبقى مع القرار

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

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

كيف تكتب وثيقة يقرؤها الفريق فعلاً؟ Readable Documents

الفريق لن يحب الكتابة إذا كانت الوثائق التي يقرؤها متعبة. وأغلب التعب لا يأتي من الموضوع، وإنما من ترتيب الوثيقة. فالقارئ المشغول يقرأ أول فقرة، ثم ينظر في العناوين، ثم يقرر هل يكمل. لذلك ضع ما يحتاجه في أول الصفحة، وليس في آخرها.

وأبسط طريقة لذلك رأس ثابت Header في أعلى كل وثيقة، يعرف منه القارئ في عشر ثوان ما المطلوب منه:

السطرمثاللماذا
الحالة Statusمسودة، مفتوحة للتعليق، حسمت، متروكةيعرف القارئ هل رأيه ما زال يغير شيئاً
المطلوب منك«أحتاج رأي فريق البيانات في القسم 4 فقط»لا يقرأ الجميع كل شيء
صاحب القرار والموعد«يقرر قائد المنصة، والتعليقات حتى الأربعاء»النقاش له نهاية معروفة
الخلاصة في ثلاثة أسطرالمشكلة، والحل المقترح، والثمنمن لا يكمل يعرف الفكرة على الأقل
الروابطالتذكرة Ticket، والقرارات السابقة، واللوحة Dashboardالسياق في مكان واحد

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

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

ما دور قائد الفريق؟ The Lead's Role

ثقافة الكتابة تنتقل من الأعلى أكثر مما تنتقل بالقواعد. فإذا كان القائد يقرر في المحادثات الجانبية ثم يطلب من الفريق أن يكتب، فلن يكتب أحد بجدية. وإذا كان يقرأ الوثائق ويعلق عليها بعناية، ويذكر في الاجتماع «كما كتب فلان في وثيقته»، فسيعرف الجميع أن الكتابة تحسب.

وهذه أشياء صغيرة يفعلها القائد وتصنع الفرق:

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

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

بأي لغة يكتب الفريق العربي؟ Language Choice

هذا سؤال لا تجيب عنه المصادر الأجنبية، لكنه حقيقي في أغلب فرقنا. فبعض الفريق يكتب بالعربية بارتياح، وبعضه لا يقرأ العربية، والمصطلحات التقنية كلها بالإنجليزية، والإدارة قد تطلب العربية في المراسلات الرسمية.

ولا توجد إجابة واحدة، لكن هناك قواعد تقلل المشكلة:

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

متى تتحول الكتابة إلى بيروقراطية؟ Writing Theater

كل عادة جيدة يمكن أن تصبح شكلاً فارغاً. والفريق الذي يفرض وثيقة لكل تغيير صغير سيكتب وثائق لا يقرؤها أحد، ثم يكره الكتابة كلها. ويقول Malte Ubl في مقاله عن Google إن الوثيقة تكتب لمشكلة فيها غموض وخيارات حقيقية، وإنها لا تفيد إذا كان الحل واضحاً أو كانت الوثيقة دليل تنفيذ ليس فيه موازنة بين خيارات.

وهذه علامات أن الكتابة عندكم أصبحت عبئاً:

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

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

ومن الأمثلة الواضحة على هذا الربط ما كتبه Will Larson في مقاله Writing an engineering strategy عام 2023: إذا أردت أن تكتب استراتيجية هندسية Engineering Strategy، فاكتب خمس وثائق تصميم، واستخرج ما يتشابه فيها. أي أن الوثائق الصغيرة عن قرارات حقيقية هي الأساس، والوثائق الكبيرة تبنى منها لاحقاً، وليس العكس.

أخطاء شائعة Common Mistakes

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

قائمة تحقق Checklist

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

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

دليلرسائل العمل التي تقرأ فعلاً: Email وChat والتذاكركيف تكتب بريداً ورسالة محادثة وتذكرة يفهمها القارئ من أول سطرين ويرد عليها بسرعة، مع أمثلة قبل وبعد.دليلكيف تشرح عملك التقني لغير المختصين Non-technicalكيف تشرح عملك التقني للعميل والإدارة والمبيعات والقانوني وأهلك بطبقات وتشبيهات ولغة واضحة، مع أمثلة قبل وبعد.دليلكتابة توثيق يعود إليه القارئ: README ودليل التشغيلكيف تكتب ملف README ودليل تشغيل ووثيقة تصميم يجد فيها القارئ جوابه، ويبقى صحيحاً بعد أن يتغير النظام.دليلالقرار التقني في الفريق: سجل ADR والخلاف المحترمكيف تحدد حجم القرار التقني ومن يملكه، وتديره بوثيقة تصميم ومراجعة وسجل قرار ADR، ثم يختلف الفريق ويلتزم.دليلتوثيق المعمارية: مخططات C4 وسجلات القرارات المعمارية ADRكيف ترسم نظامك بمخططات C4 يفهمها المطور الجديد، وتحفظ سبب كل قرار مهم في سجل ADR داخل المستودع.دليلقاعدة معرفة الفريق Wiki: نظمها ليجد الناس ما يبحثون عنهلماذا تضيع معرفة الفريق في المحادثة، وكيف تبني Wiki لها مالك ومراجعة وبحث يفهم الكلمات العربية، مع مختبر يقيس البحث العربي في PostgreSQL.

الخلاصة

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

سجل التحديثات

  • 2026-11-19: كتابة المقال، والتحقق من رسالة Amazon لعام 2017، ودليل GitLab، ووثيقة Oxide RFD 1، ومقال Nygard، ووثيقة RFC 3، ومقالي Malte Ubl وWill Larson من مصادرها في نفس التاريخ.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.