כיצד מראיינים כתב טכני טוב?1. ?כיצד מראיינים כתב טכני טוב
אני עובד בהייטק כבר 02 שנה. ההתמחות שלי היא תיעוד טכני, אך הייתי גם מנהל מוצר ומנהל
ומהנדסי מערכות. אך איני מהנדס, ומשום כך מעולם לאQA פרויקטים; ניהלתי מפתחים, אנשי
סמכתי על עצמי שאוכל לראיין ולבחור אדם לתפקיד שקשור בהנדסה גרידא – פיתוח תוכנה, עיצוב
אלגוריתם וכדומה – ללא המעורבות של בעל ניסיון בתחומים הספציפיים הללו. אני פשוט לא יודע
.(מספיק )ואני גם לא יודע איך לפתור את חידוני השחמט
משום כך מרגיז אותי לראות שמנהלי מו"פ, מנהלי מוצר ומהנדסים אחרים חושבים שיש בידם את
הכישורים לבחור בכתב טכני טוב. לעיתים הם עושים את הטעויות הטיפשיות ביותר. ופעמים רבות
,הם טועים טעות מרה ועליהם לתקן את הטעות הזו ולחפש כתב טכני אחר )מה שדווקא משמח אותי
.(, החברה שלי, כדי שנציל אותםJBSכי במקרים רבים הם מתקשרים ל
אך אם גם אתה הייטקיסט שמעוניין לגייס כתב טכני ואינך רוצה להיעזר במומחה מנוסה לענייני
תיעוד, אני חש חובה אתית לעזור לך )הניסיון שלי בתיעוד טכני מפצה על החוסר בתואר הנדסי, ואני
.(שמח לשתף את המידע
חשוב לזכור שלמרות שתיעוד טכני מהווה חלק ממחזור הפיתוח הכולל של המוצר, עדיין מדובר
בהתמחות נפרדת. אם תנסה לראיין ולבחור כתב טכני בדרך בה אתה בוחר מפתח, רוב
.הסיכויים שתיכשל
.הכל מתחיל באופן קיום הריאיון ובשאלות שאתה שואל
.הנה כמה טיפים שיעזרו לך לעשות את העבודה הרבה יותר טוב
2. טעויות נפוצות שאנשי הייטק עושים כשהם מראיינים
ובוחרים כתב טכני
(הנה כמה מהטעויות השכיחות ביותר שאנשים בתפקידך )מנהלים טכניים חסרי ניסיון רב בתיעוד
:עושים
.1הם אומרים דברים כגון "לא נורא אם אינך דובר שפת אם אנגלית; תמיד נוכל לבדוק
6 ראה שאלה חשובה מאוד מספר ."את הטקסט שכתבת בעזרת בודק שגיאות כתיב
.(בהמשך )רמז, כלים הם רק כלים, ומה שחשוב זה התוכן
.2הם מצפים מכתב טכני להיות מנהל תיעוד ולדעת כיצד לתכנן, לתזמן ולתת עדיפות
כמובן שמישהו צריך להיות אחראי על תוכנית העבודה, אך לא .לערכת התיעוד המלאה
ראה שאלה חשובה .כל הכתבים הטכניים מתאימים לשמש גם כמנהלי פרויקט תיעוד
.מאוד מספר 5 בהמשך
.3ונותנים לכך םהם מתעקשים על כך שלכתב הטכני יהיה ניסיון בתחום הספציפי שלה
." טכנידמאוד, מאו ; הם אומרים דברים כגון "המוצר שלנו מאוד טכני.חשיבות עליונה
בשרתי ,Hadoopוגם דברים כגון "הכתב הטכני שיעבוד עמנו חייב להיות מנוסה ב
מאוד, מאוד, מאוד . )משום שהמוצר שלנוYARN ובמערכות מבוססותApache
שכתב כמה יצליחו לאתר כתב טכני וכולי…(” הם מתמקדים בכך, ויכול להיות שהם אכן
. אך רוב הסיכויים שהם שכחו לשאול אותו אתHadoopעמודים על מוצר שקשור ב
אך קשהHadoopהשאלות החשובות באמת. לדוגמה, יכול להיות שהוא מתמצא ב
.ראה שאלות חשובות באמת 1 ו2 בהמשך .לעבוד אתו
.4,הם שואלים שאלות כגון: "כמה זמן עבודה אתה גוזל מהמהנדסים שלנו.. אהמ
;כלומר, לכמה זמן אתה זקוק מהמהנדסים שלנו?". זהו אכן שיקול לגיטימי וחשוב
ראה שאלה חשובה .אך גם אם תשאל את השאלה, לא תקבל את המידע הרצוי
באמת מספר 3 בהמשך
.5הם אומרים דברים כגון "בדקנו את הנושא ונראה .לעיתים הם מתקבעים על כלי תיעוד
2.62 גרסהJava Markdown Latexלנו שאנחנו צריכים לכתוב את התיעוד שלנו ב
4 ראה שאלה חשובה באמת מספר – ”. RESTful JSON frameworkולפרסם אותו ב
.(בהמשך )רמז, כלים הם רק כלים, ומה שחשוב זה התוכן