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

השלב הנוכחי:
התוצאות יוכרזו ציר הזמן.

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

מבוא

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

תחילת התהליך

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

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

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

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

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

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

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

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

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

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

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

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