Architecture Decision Record

Active theme: Light

← מסמכים

עצות לעבודת צוות ב-ADR

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

יש לכם הזדמנות להוביל את חברי הצוות, על ידי שיחה משותפת על ה"למה", במקום לכפות את ה"מה". לדוגמה, רשומות החלטה הן דרך לצוותים לחשוב חכם יותר ולתקשר טוב יותר; רשומות החלטה אינן בעלות ערך אם הן רק דרישת ניירת כפויה שנעשית בדיעבד.

חלק מהצוותים מעדיפים בהרבה את השם "החלטות" על פני הקיצור "ADR". כשצוותים מסוימים משתמשים בשם הספרייה "decisions", זה כאילו נדלקת נורה, והצוות מתחיל להכניס לספרייה יותר מידע, כמו החלטות ספקים, החלטות תכנון, החלטות לוחות זמנים ועוד. לכל סוגי המידע האלה אפשר להשתמש באותה תבנית. אנחנו משערים שאנשים לומדים מהר יותר עם מילים ("החלטות") מאשר עם קיצורים ("ADR"), ושאנשים מונעים יותר לכתוב מסמכי עבודה בתהליך כשמסירים את המילה "רשומה", וכן שחלק מהמפתחים וחלק מהמנהלים לא אוהבים את המילה "ארכיטקטורה".

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