בחירת כותב טכני

השלב הנוכחי:
פיתוח המסמכים. להסבר על ציר הזמן

בדף הזה תמצאו טיפים לארגוני קוד פתוח שיעזרו לכם להעריך ולבחור את הכותב הטכני המתאים להצעה שלהם לפרויקט Google עונתי של Docs.

מבוא

ארגוני קוד פתוח צריכים להעסיק כותבים טכניים שיעבדו על הפרויקט שהם מציעים. ארגונים צריכים להשיג כותבים טכניים משלהם. כותבים טכניים שרוצים לעבוד עם ארגונים שמשתתפים בעונה של Google Docs יכולים למצוא במאגר GitHub של Google עונה, ובערוץ#השליטה בלבד בערוץ Write the Docs Slack.

תחילת התהליך

מומלץ להתחיל בתהליך של איתור כותבים טכניים בהקדם, כי נראה לכם שתרצו להשתתף בעונה של Google Docs.

הערכת כותב טכני

מומלץ לבקש דוגמאות למסמכים שפותחו בעבר מהכותבים הטכניים שאתם שוקלים להשתמש בהם, כדי להעריך את כישורי הכתיבה הטכנית ואת הניסיון שלהם.

כישורי כתיבה טכניים וניסיון כתיבה

  • בחינת הניסיון הקודם של הכותב הטכני. במצב אידיאלי, לכותב הטכני צריך להיות ניסיון קודם בכתיבת מסמכים טכניים לתעשיית התוכנה. אחת המטרות של העונה של Docs ב-Google היא לתת לכותבים טכניים הזדמנות להיות מעורבים במוצרים שמיועדים למפתחים. לכן, לא חשוב שהכותב יהיה בעל ניסיון בממשקי API, בערכות SDK או בפלטפורמות אחרות למפתחים, גם אם הפרויקט שלכם מתמקד בקהל המפתחים.

  • מתמקדים במיומנויות שפה ותקשורת. אפשר לבחון את העבודה הקודמת של הכותב הטכני מנקודת מבט זו. והכי חשוב: האם אפשר להבין מה כותב האדם הזה? אם אתם רוצים לבדוק לעומק את שפת היצירה של הכותב הטכני, ודאו שיש עקביות מבחינת פיסוק וניסוח, איות נכון ושפה ברורה. האם הניסוח פשוט או מורכב? האם המשפטים קצרים או שהם ממשיכים עד שקשה לעקוב אחריהם?

  • חשוב לשים לב לעיצוב ולפריסה של המסמכים. מומלץ לבדוק את הפריסה הכוללת של דוגמאות המסמכים. האם העיצוב הגיוני? האם אפשר להתמצא בקלות במסמך או במערך המסמכים? האם יש כפילות בתוכן או האם יש פערים ברורים?

העסקת כותב טכני

על הארגונים להעסיק כותב טכני ולמלא את טופס הוכחת ההעסקה של כותבים טכניים, שמפורט בהמשך עד 22 במאי 2024 בשעה 18:00 לפי שעון UTC.

השלמת שלב גיוס הכותבים הטכניים.

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

הערה: ארגונים שלא שכרו כותבים טכנולוגיים ושלחו את טופס ההעסקה להוכחת כותבים טכניים עד 22 במאי 2024 בשעה 18:00 UTC, לא יקבלו כספים בתאריך התשלום הראשון.