{הכותרת שלכם כאן}

!!! info

**מצב**: { מוצעת | בבדיקה | התקבלה | נדחתה | הוחלפה | הוצאה משימוש }

**עודכן**: {YYYY-MM-DD}

תקציר

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

גורמים מניעים

{בסעיף הזה מוסבר למה ההחלטה הזו מתקבלת עכשיו. נסחו בבירור את המניעים, הצרכים או הבעיות העיקריים שמחייבים את ההחלטה הארכיטקטונית הזו. חשבו על הסיבות והלחצים שמאחוריה.}

• {למשל: אנחנו מפתחים יכולת/תכונה חדשה שצריכה...}

• {למשל: אנחנו צריכים לשפר ביצועים, נגישות, להסיר חוב...}

• {למשל: משוב ממשתמשים מצביע על...}

• {למשל: הגישה הנוכחית מטילה את המגבלות האלה...}

אפשרויות

{כאן מפרטים את האפשרויות השונות שאתם שוקלים. הישארו עם עובדות והימנעו מדעות; הסעיף הבא עוסק בניתוח. כללו תיאור תמציתי וקישורים לתיעוד או לדוגמאות רלוונטיים.

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

{כותרת אפשרות 1}

{תארו את האפשרות, ספקו תקציר, פרטו עובדות, ספקו קישורים וכדומה.}

{כותרת אפשרות n}

...

ניתוח אפשרויות

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

שקלו היבטים כמו:

• עלות (פיתוח, תפעול, רישוי)

• מורכבות (מימוש, תחזוקה, עקומת למידה)

• סיכונים (טכניים, תפעוליים, אבטחתיים)

• התאמה לעקרונות ארכיטקטורה או לתקנים קיימים

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

כללו כמה שיותר הצהרות יתרון/חיסרון/אחר לפי הצורך. }

{הערכת אפשרות 1}

• יתרון: {יתרון או תועלת ספציפיים של האפשרות הזו.}

• חיסרון: {חיסרון, סיכון או עלות ספציפיים הקשורים לאפשרות הזו.}

• אחר: {נקודה רלוונטית שאינה בהחלט יתרון או חיסרון.}

{הערכת אפשרות n}

...

המלצה

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

השלכות

{הסעיף הזה אופציונלי.}

{עכשיו, כשהתקבלה החלטה, מהן התוצאות וההשפעות הצפויות, חיוביות ושליליות? אילו מגבלות, עלויות או סיכונים ידועים מתקבלים בעקבות ההחלטה הזו? איך ההחלטה הזו תשפיע על בעלי עניין שונים, מערכות אחרות, נוהלי פיתוח, נהלים תפעוליים או חוויית המשתמש?}

• יתרון: {תוצאה חיובית או תועלת ספציפית הצפויה מההחלטה הזו.}

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

• אחר: {השלכה שאינה בהחלט יתרון או חיסרון.}

אימות

{הסעיף הזה אופציונלי.}

{תארו איך יאומת מימוש ההחלטה הזו ואיך יובטח ציות מתמשך. זה עוזר להראות שההחלטה אינה רק תיאורטית אלא תיושם ותנוטר באופן פעיל.

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

איך תישמר ההקפדה על ההחלטה הזו לאורך זמן? (למשל בדיקות אוטומטיות, ביקורות תקופתיות, עדכוני הנחיות צוות, הדרכה).

האם יש מדדים או אינדיקטורים ספציפיים שיראו שההחלטה משיגה את התוצאות החיוביות המיועדות? (למשל מדדי ביצועים, שיעורי אימוץ, הפחתה בשגיאות מסוימות, ציוני משוב ממשתמשים).

מי אחראי לפקח על כך, ומה קורה אם ההחלטה אינה מקוימת?}

מידע נוסף

{הסעיף הזה אופציונלי.}

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

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