برنامه نویسی

تصمیمات مستند سازی – جامعه dev

جلسات برای تصمیمات است و این تصمیمات باید مستند شود.

  • تصمیم باید مستند شوید و علاوه بر تصمیم اتخاذ ، اطلاعات اضافی زیر را نیز درج کنید یا به آن مراجعه کنید:
    • دلایلی که تصمیم گرفته شد
    • هر گزینه ای در نظر گرفته شده است
    • هرگونه پیامدهای پذیرفته شده ناشی از تصمیم
    • وقتی تصمیم گرفته شد
  • به دنبال یک تصمیم ، آن باید تعریف شود که چه کسی باید در مورد تصمیم توسط زمان و به چه شکلی مطلع شود.
  • تصمیمات مربوط به معماری نرم افزار باید در قالب تصمیم گیری در مورد معماری زیر (ADR) مستند شود.

وضعیت: [Draft, Proposed, Accepted, Deprecated, Superseded]

زمینه

توصیف ارزش خنثی از نیروهای بازی (تکنولوژیکی ، سیاسی ، اجتماعی و خاص پروژه)

تصمیم

تصمیم اتخاذ شده ، از جمله استدلال پشت آن.

طرف دیگر

هر گزینه دیگری که در نظر گرفته شده است ، از جمله دلایل رد آنها.

متفاوتی

اطلاعات اضافی مانند “ایجاد بر” ، “پذیرفته شده” ، …

  • ADR باید تحت کنترل منبع قرار گیرد و در پروژه مربوطه در آن ذخیره شود doc پوشه
  • درخواست ها قوطی برای بحث و تأیید ADR استفاده کنید.

حتماً پست مایکل نیگارد را در مورد مستندسازی تصمیمات معماری بررسی کنید

تصمیمات در جلسات مکرر

برای جلسات مکرر ، من دوست دارم آنها را در یک سند بزرگ که حاوی دقایقی از جلسه است ، به DOS ، … فرمت تصمیم گیری ها شبیه به مورد برای DOS است ، ببینید.
مدیریت DOS در جلسات مکرر ، هنگامی که هیچ ابزار توافق نشده ای وجود ندارد.

  • تصمیم-001 تصمیمات معماری باید تحت کنترل منبع قرار گیرد

    • دلیل: تصمیمات را می توان در درخواست های کشش مورد بحث قرار داد ، تغییرات ردیابی می شوند ، تصمیمات به راحتی برای توسعه دهندگان و نزدیک به کد در دسترس است
    • عواقب: دسترسی به خوانندگان مخزن محدود است
    • گزینه های دیگر: تلاقی ، ویکی ، اسناد کلمه
    • all-001 جان 2025-02-14: به همه معماران و توسعه دهندگان در مورد این تصمیم اطلاع دهید
  • اگر هیچ ابزار ردیابی تصمیم گیری در سطح سازمان وجود ندارد ، قالب فوق قوطی استفاده شود

نوشته های مشابه

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

دکمه بازگشت به بالا