קוראים כדי למצוא פעולה
לפני הקריאה, הגדירו מה אתם מחפשים: איך מפעילים אפשרות, מה נדרש לפני התקנה או מה פירוש הודעת שגיאה. התחילו בכותרת, בתנאים ובדוגמה. קראו את המשפטים שסביב המידע הדרוש, ורק אז הרחיבו אם חסר הקשר. אין צורך לתרגם כל מילה כדי לזהות פעולה אחת.
לדוגמה, Save your changes before closing the window. פירושו: שמרו את השינויים לפני סגירת החלון. המילה before קובעת את סדר הפעולות. בתרגול, כתבו בעברית מה עושים קודם ומה אחר כך. לאחר מכן נסחו באנגלית הוראה דומה לגבי קובץ דמיוני.
בנו מילון קטן מתוך מה שקראתם. documentation הוא תיעוד, requirement הוא דרישה, ו־permission היא הרשאה בהקשר של גישה למערכת. לצד כל מילה כתבו משפט: You need permission to edit this file. כלומר, דרושה הרשאה לעריכת הקובץ. כך אתם מתרגלים גם משמעות וגם שימוש.
מתארים תקלה שאפשר לבדוק
דיווח כמו It doesn't work. אומר שמשהו אינו עובד, אבל משאיר לקורא הרבה שאלות. נסו לציין מה ניסיתם לעשות, באיזו סביבה, מה היו הצעדים ומה ראיתם. תבנית התרגול הבאה יכולה לעזור; בעבודה השתמשו בתבנית שהצוות שלכם בחר.
- כותרת: The download button shows an error. כפתור ההורדה מציג שגיאה.
- סביבה: Environment: test website, desktop browser. אתר בדיקות בדפדפן במחשב. בדיווח אמיתי הוסיפו גרסה אם היא רלוונטית.
- צעדי שחזור: Open the report page. Select a report. Click Download. פתחו את עמוד הדוחות, בחרו דוח ולחצו על הורדה.
- תוצאה צפויה: Expected: the file downloads. הקובץ אמור לרדת.
- תוצאה בפועל: Actual: an error message appears. בפועל מופיעה הודעת שגיאה.
הביטוי steps to reproduce מתייחס לצעדים שמאפשרים לנסות לשחזר את התקלה. סדרו אותם לפי הפעולה, בלי לערבב הסבר על הסיבה המשוערת. אם אינכם יודעים מה גרם לתקלה, אפשר לכתוב I haven't identified the cause yet. פירושו: עדיין לא זיהיתי את הסיבה.
העדיפו תיאור של פעולה מסוימת על פני ניסוח עמום. המדריך של Google למשפטים ברורים בכתיבה טכנית ממליץ לבחור פעלים מדויקים ולציין בבירור מי או מה מבצע את הפעולה. בתרגיל שלנו, הכפתור מציג שגיאה הוא מידע שימושי יותר ממשהו לא בסדר.
עדכון קצר באנגלית להייטק: מה הושלם ומה חסר
בישיבת צוות קצרה, המכונה לעיתים סטנדאפ, אפשר להכין שלושה משפטים: מה עשיתם, מה תעשו בהמשך ומה מעכב אתכם. זו תבנית לתרגול, ואפשר להתאים אותה לאופי העדכונים בצוות. התחילו במידע שאנשים צריכים כדי להמשיך לעבוד.
I tested the login page. Next, I will check password reset. I need access to the test environment. פירושו: בדקתי את עמוד הכניסה. בהמשך אבדוק איפוס סיסמה. אני צריך גישה לסביבת הבדיקות. המשפט האחרון נותן לצוות בקשה שאפשר להתייחס אליה.
שימו לב להבדל בין I tested, בדקתי, לבין I'm testing, אני בודק כעת. שינוי קטן בזמן הפועל משנה את מצב המשימה. אם הבדיקה התחילה אך לא הסתיימה, אל תבחרו ניסוח שמציג אותה כהושלמה.
כשיש עיכוב, ציינו מה חסר בלי להמציא מועד סיום. I can't complete the test without access. אומר שלא ניתן להשלים את הבדיקה בלי גישה. אפשר להוסיף Could you help me get access? כלומר, תוכלו לעזור לי לקבל גישה? זו בקשה ישירה ומנומסת.
שואלים על הפרט שחסר
אם הבקשה רחבה, שאלו שאלה ממוקדת. Do you mean the mobile app or the website? פירושו: האם הכוונה לאפליקציה בנייד או לאתר? כשחסר מועד, אפשר לשאול When do you need the update? כלומר, מתי אתם צריכים את העדכון?
לפעמים שמעתם את המילים אך לא הבנתם את ההחלטה. נסו לבדוק את ההבנה: Just to confirm, should we test this before the release? כלומר, רק כדי לוודא, האם צריך לבדוק זאת לפני שחרור הגרסה? החזרה על הפעולה ועל המועד מאפשרת לעמית לתקן אתכם.
אם הדיבור מהיר, בקשו לחזור על חלק מסוים: Could you repeat the last step? פירושו: תוכלו לחזור על השלב האחרון? אין צורך לומר שהבנתם כשהשלב חסר. בתרגול בזוגות, אחד נותן הוראה והשני שואל על פרט שהושמט בכוונה, כגון שם הקובץ או המועד.
משאירים סיכום שאפשר להמשיך ממנו
אחרי שיחה, כתבו מה הוחלט, מי אחראי ומה הצעד הבא. לדוגמה: We agreed to test the fix tomorrow. I will run the test and share the results. פירושו: סיכמנו לבדוק את התיקון מחר. אני אבצע את הבדיקה ואשתף את התוצאות. הדוגמה מציגה אחריות, אבל אינה קובעת עבורכם נוהל עבודה.
בהעברת משימה לעמית, הוסיפו גם מצב נוכחי: The report is ready for review. The mobile check is still pending. Please review the report first. כלומר, הדוח מוכן לבדיקה, בדיקת הנייד עדיין ממתינה, ובבקשה בדקו קודם את הדוח. החליפו מילה כמו it בשם הדבר כשהקורא עלול לא לדעת למה התכוונתם.