Architecture Decision Record

Active theme: Light

← מסמכים

הצעות לכתיבת ADR טובים

מאפיינים של ADR טובה:

  • נימוק (Rationale): הסבירו את הסיבות לקבלת ה-AD המסוימת. זה יכול לכלול את ההקשר (ראו להלן), יתרונות וחסרונות של בחירות אפשריות שונות, השוואות בין יכולות, דיונים על עלות/תועלת ועוד.

  • ספציפית (Specific): כל ADR צריכה לעסוק ב-AD אחת, לא בכמה AD.

  • חותמות זמן (Timestamps): ציינו מתי נכתב כל פריט ב-ADR. זה חשוב במיוחד להיבטים שעשויים להשתנות עם הזמן, כמו עלויות, לוחות זמנים, הרחבה וכדומה.

  • בלתי ניתנת לשינוי (Immutable): אל תשנו מידע קיים ב-ADR. במקום זאת, תקנו את ה-ADR על ידי הוספת מידע חדש, או החליפו את ה-ADR על ידי יצירת ADR חדשה.

מאפיינים של סעיף "הקשר" (Context) טוב ב-ADR:

  • הסבירו את מצב הארגון שלכם ואת סדרי העדיפויות העסקיים שלו.

  • כללו נימוקים ושיקולים המבוססים על ההרכב החברתי וההרכב הכישורי של הצוותים שלכם.

  • כללו יתרונות וחסרונות רלוונטיים, ותארו אותם במונחים שמתאימים לצרכים ולמטרות שלכם.

מאפיינים של סעיף "השלכות" (Consequences) טוב ב-ADR:

  • הסבירו מה נובע מקבלת ההחלטה. זה יכול לכלול השפעות, תוצאות, תפוקות, מעקבים ועוד.

  • כללו מידע על כל ADR עוקבות. די נפוץ ש-ADR אחת מעוררת צורך ב-ADR נוספות, למשל כשה-ADR אחת מקבלת בחירה כוללת גדולה, שבתורה יוצרת צורך בהחלטות קטנות נוספות.

  • כללו כל תהליך סקירה לאחר הפעולה. מקובל שצוותים סוקרים כל ADR חודש לאחר מכן, כדי להשוות את מידע ה-ADR למה שקרה בפועל, כדי ללמוד ולצמוח.

ADR חדשה יכולה לתפוס את מקומה של ADR קודמת:

  • כשמתקבלת AD שמחליפה או מבטלת ADR קודמת, יש ליצור ADR חדשה