Architecture Decision Record

Active theme: Light

← وثائق

نصائح العمل الجماعي لسجلات ADR

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

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

تفضّل بعض الفرق اسم «القرارات» (decisions) كثيرًا على الاختصار «ADR». وحين تستخدم بعض الفرق اسم المجلد «decisions» يكون الأمر كمن أُضيء له مصباح، فيبدأ الفريق بوضع مزيد من المعلومات في المجلد، مثل قرارات الموردين وقرارات التخطيط وقرارات الجدولة وغيرها. وكل هذه الأنواع من المعلومات يمكن أن تستخدم القالب نفسه. ونفترض أن الناس يتعلمون أسرع بالكلمات («القرارات») منهم بالاختصارات («ADR»)، وأنهم أكثر حماسًا لكتابة وثائق العمل الجارية عند إزالة كلمة «سجل»، وأن بعض المطورين وبعض المديرين يكرهون أيضًا كلمة «بنية معمارية».

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