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