يقرأ الوكلاء كودك. السياق هو المكان الذي تضيف فيه ما لا يستطيع الكود التعبير عنه — القرارات والقيود والاتفاقيات التي توجد خارجه.
للاطلاع على الأسباب وراء وجود هذا المحتوى هنا، اقرأ عن سياق المشروع في قسم المفاهيم. وتغطي هذه الصفحة كيفية إدارته.
إضافة سياق
افتح قسم السياق في مشروعك وأضف مدخلاً. يحتوي كل مدخل على عنوان ونص، ويمكن تعديله أو حذفه لاحقًا.
المدخلات الجيدة قصيرة ومحددة وثابتة. قرارات الهندسة المعمارية واتفاقيات الأسلوب وعقود API وحدود الملكية والقيود الصريحة كلها تنتمي إلى هذا النوع. أما سرد عملية التوظيف وأي شيء واضح من الـ repository فلا يندرج ضمنه.
احرص على فصل المدخلات وتسميتها بشكل منفصل
مدخل واحد لكل موضوع، مع عنوان يوضح محتواه. يمكن استرجاع "اتفاقيات التعامل مع الأخطاء" و"الوحدات المتجمدة"؛ أما مدخل واحد بعنوان "ملاحظات" ويحتوي على كليهما فلا يمكن استرجاعه بسهولة.
وهذا مهم لأن السياق يتم تحميله بشكل انتقائي بناءً على المهمة الحالية — انظر إلى المهارات التدريجية. فالمدخلات المنفصلة جيداً تسمح بتحميل المدخل المناسب للمهمة المناسبة.
المراجع
بالإضافة إلى المدخلات النصية، يمكنك إرفاق مراجع — روابط ومستندات تشير إلى مواد موجودة في أماكن أخرى. استخدم هذه الميزة عندما يكون النسخة الأصلية موجودة في ويكي أو أداة تصميم ولا ترغب في وجود نسخة ثانية قد تتغير وتصبح غير محدثة.
سياق كل مهمة على حدة
السياق الموجود على مستوى المشروع ينطبق على كل محتوياته. أما المواد المتعلقة بجزء معين من العمل — مثل تذكرة، تقرير عميل، أو مستند تصميم — فيجب إرفاقها بتلك المهمة بدلاً من ذلك. فالملاحظة الخاصة بالمهمة المخزنة في سياق المشروع ستشكل ضجيجًا في كل المهام اللاحقة.
الحفاظ على دقة السياق
السياق القديم أسوأ من غياب السياق، لأن الوكلاء يعتبرونه مرجعًا موثوقًا. عندما تتغير اتفاقية ما، يجب تحديث المدخل في نفس التغيير الذي يطرأ على الكود.
مراجعة ما هو موجود
اقرأ سياقك من حين لآخر كما لو كنت مستخدمًا جديدًا. فالمدخلات تتراكم، والمدخلات التي كُتبت خلال عملية ترحيل انتهت قبل عام قد تصبح الآن مضللة بشكل كبير.