שיעור 13 — הצגת פרויקטים
מטרות
- להראות מערכת שרצה, ולא רק לתאר אותה.
- להציג כשל אחד ולהסביר איפה הוא קרה.
- להשוות לבסיס פשוט יותר, עם מספרים.
- להסביר החלטה אחת בקוד, כל אחד ואחת בעצמם.
שלושה דברים שמראים
בהצגה צריך להיות אפשר להראות שלושה דברים:
- המערכת רצה על דוגמה אמיתית מן המאגר שלכם.
- מקרה אחד נכשל, ואתם יודעים אם הכשל בחיפוש, בהחלטה, בכלי, או בתיאום.
- יש השוואה לגרסה פשוטה יותר: אותם מקרים, עם מספר הצלחות ומספר קריאות.
כל סטודנט או סטודנטית צריכים להסביר החלטה בקוד, גם אם העבודה הוגשה בזוג. שאלות ההגשה והקבצים הרשמיים נמצאים במודל.
טבלת השוואה
טבלה אחת מספיקה. היא עונה על השאלה אם המורכבות שהוספתם קנתה משהו:
| מדד | בסיס פשוט | המערכת שלכם |
|---|---|---|
| הצלחות | ||
| סירובים נכונים | ||
| קריאות | ||
| זמן |
אם המערכת שלכם לא טובה מהבסיס, זה ממצא. הציגו אותו, והסבירו מה הייתם בודקים בהמשך.
הצגת כשל
בחרו מקרה אחד שנכשל, והראו את היומן שלו. ענו על ארבע שאלות:
- מה הייתה התשובה הנכונה, ואיך אתם יודעים.
- באיזה צעד ביומן הדרך התפצלה.
- האם הכשל בחיפוש, בהחלטה, בכלי, או בתיאום.
- מה הייתם משנים, ואיך הייתם בודקים שהשינוי עזר בלי לשבור מקרים אחרים.
כשל שאתם יודעים לאתר מראה שאתם מבינים את המערכת. הצגה בלי שום כשל מעוררת את השאלה אם בדקתם מספיק מקרים.
לפני ההצגה
- הרצה מלאה מתיקייה נקייה, לפי ה־README, על המחשב שבו תציגו.
- תוכנית גיבוי אם הרשת או שירות המודל לא זמינים: יומן שמור של ריצה אמיתית, מסומן ככזה.
- כל אחד ואחת בזוג יודעים להסביר כל חלק בקוד, לא רק את החלק שכתבו.
ערכו חזרה מלאה בזוג, עם שעון. אחד מציג, והשני שואל שתי שאלות: „למה לא תהליך קבוע?” ו„מה קורה אם הכלי הזה נכשל?”. החליפו תפקידים.
בדיקת הבנה
סיכום
מצאתם טעות בעמוד? כתבו למרצה