בדקנו את העובדות בדפי העבודות שלנו
לפני שדפי העבודות שלנו עלו, בדקנו כל טענה מול הקוד האמיתי והאתרים החיים. חלק מהניסוח הראשון שלנו היה שגוי. הנה מה שהשתנה.
2 דקות קריאה
הטיוטה הראשונה שלנו של דף העבודה על ציון ברגע אמרה שמורים יכולים לסמן במבחן בעט או בעיפרון. הוכחנו רק עט. אז העיפרון יצא.
התיקון הקטן הזה הוא כל הרעיון של הסיפור: להגיד רק מה שאפשר להוכיח.
בקצרה
- בדקנו כל טענה בדפי העבודות שלנו מול הקוד האמיתי והאתרים החיים.
- טענות שגויות או לא מוכחות תוקנו או הוסרו.
- שלוש טענות שונו: העיפרון, הטענה שאין צד אחורי והטענה שכל ההגדרות בכתובת האתר.
- מספרים נשארו רק היכן שנספרו, ואנחנו לא משתמשים במספרים על מהירות, מחיר או לקוחות.
למה עשינו את זה
העבודות שלנו הן החלק באתר שהכי סומכים עליו. מי שקורא אותם מחליט אם לשכור אותנו. טענה גדולה מעט מדי היא התחלה גרועה.
איך עשינו את זה
בכל אחד משלושת הפרויקטים קראנו את הקוד האמיתי, את הערות הפרויקט ואת האתר החי. רשמנו כל טענה שרצינו להגיד וסימנו כל אחת: אושרה, שגויה, מיושנת, מטעה, אי אפשר היה לבדוק, או שרק הבעלים יודע.
אחר כך מי שבנה את הפרויקטים קרא את הבדיקה ותיקן אותה בכל מקום שבו טעינו. רק אחרי זה כתבנו מחדש את דפי העבודות לפי הבדיקות.
מה השתנה
- ציון ברגע. סימון בעט מוכח, ולכן הטקסט אומר עט. עיפרון לא נטען.
- שפי לומדה. שורה מוקדמת אמרה שלקורס אין צד אחורי. זה היה שגוי. הקורס משתמש ב־Firebase לאירוח (שמירת האתר באוויר), לחשבונות אופציונליים ולסנכרון אופציונלי בענן. מספר השיעורים, 306 בכל שפה, נספר מהקוד.
- קדיש יתום. אמרנו שכל ההגדרות נמצאות בכתובת האתר. זה נכון להגדרות של הדף, אבל לא לשפה ולערכת הצבעים.
- בכל מקום. בלי מספרים על מהירות, מחיר או לקוחות.
מה זה צד אחורי?
לתוכנה יש חזית, המסכים שאנשים רואים, ו“צד אחורי” (Back end), החלק שמאחורי המסכים ששומר נתונים ועושה את העבודה הכבדה. בחנות, החזית היא האולם והצד האחורי הוא המחסן והמשרד.
מה השארנו בחוץ
דברים שלא יכולנו להוכיח נשארו בחוץ. וכך גם כמה דברים נכונים שאינם שלנו לפרסם.
כשקוראים עובדה בדפי העבודות שלנו, היא באה מהבדיקות האלה. מה שלא יכולנו לבדוק, לא אמרנו.
שום דבר בסיפור הזה לא מתאים לחיפוש.
