השלב הנוכחי:
סיום הפרויקט. ציר הזמן
המדריך הזה מיועד לאדמינים ארגוניים שמגישים בקשה להשתתף בתוכנית Google Season of Docs או משתתפים בה.
האם כדאי לארגון שלכם להשתתף בתוכנית Google Season of Docs?
השאלות האלה יעזרו לכם להבין אם כדאי לפרויקט או לארגון שלכם בקוד פתוח להשתתף ב-Google Season of Docs.
האם הארגון או הפרויקט שלכם:
- אתם חושבים שמסמכי עזרה חדשים או מעודכנים יעזרו לכם להשיג יעד או לפתור בעיה בפרויקט או בקהילה שלכם?
- יש לכם הבנה ראשונית או היפותזה לגבי האופן שבו תמדדו את ההצלחה של פרויקט התיעוד?
- האם יש בקהילה אנשים שיהיו מוכנים לעזור בגיוס, בהערכה ובהטמעה של סופר טכני, ויהיו זמינים לענות על שאלות ולספק תמיכה אחרת במהלך הפרויקט (6-8 חודשים, כולל תקופת הגשת הבקשות)?
- האם יש לכם חבר קהילה שיכול לשמש כאדמין הארגון ולתאם את יצירת הבקשה, את המענה על השאלות של מנהלי התוכנית ואת שליחת הבדיקות החודשיות, הבדיקה הסופית ודוח המחקר? האדמין של הארגון צריך גם להיות מוכן לענות על סקרים למעקב אחרי סיום התוכנית 'עונת Google Docs'.
הארגון צריך גם לעמוד בדרישות הסף להשתתפות בתוכנית, כולל היכולת ליצור חשבון Open Collective.
תהליך הגשת הבקשה של הארגון
תהליך הגשת הבקשה לארגון מורכב משני שלבים: שלב הבדיקה ושלב הגשת הבקשה.
שלב הניתוח
התוכנית Google Season of Docs תפתח ב-22 בפברואר 2024, אבל מומלץ מאוד לארגונים להקדיש זמן כדי להשלים את השלבים בשלב הבדיקה לפני שליחת הבקשה.
- יוצרים דף של הצעת פרויקט. בדף ההצעה מופיעה רשימה של צרכים, מטרות או בעיות מרכזיים, פתרונות אפשריים לתיעוד ומדדים אפשריים. הדף הזה צריך להיות גלוי לכולם, ולאפשר לאנשים מהקהילה לתרום תוכן ולנהל דיון. כדאי לכלול מידע עבור סופרים טכניים שרוצים להשתתף – איפה הם יכולים לשאול שאלות, להביע עניין או לקבל מידע נוסף על הפרויקט? מומלץ להוסיף כתובת אימייל ליצירת קשר עם הארגון שלכם בקוד פתוח בנוגע ל-Google Season of Docs. עם זאת, מומלץ מאוד לא להשתמש בכתובת אימייל אישית ככתובת האימייל ליצירת קשר עם הארגון שלכם בקוד פתוח. (כאן תוכלו למצוא דוגמאות).
- כדאי לפרסם את דף ההצעה בערוצי הקהילה שלכם ולהוסיף את הארגון שלכם לרשימת הארגונים המעוניינים ב מאגר GitHub של Google Season of Docs. אפשר גם לשתף את הקישור בערוץ #season-of-docs ב-Write The Docs ב-Slack. דף הקידום והעיתונות כולל סמלי לוגו ותוכן נוסף שאפשר להשתמש בהם כשמדברים על 'עונת המסמכים של Google'.
- לכל רעיון ליצירת מסמך, כדאי לחשוב על הניסיון והכישורים הנדרשים לכותב טכני כדי לעבוד בצורה מוצלחת עם הקהילה והארגון שלכם. אילו מיומנויות הקהילה שלכם יכולה לעזור לכותב טכני לפתח (לדוגמה, שימוש ב-GitHub או בכלי העבודה שלכם ליצירת מסמכים)? (כאן מוסבר איך עובדים עם סופרים טכניים).
- בקשו מתנדבים שיעזרו לענות על שאלות של כותבים טכניים מעוניינים.
- מתחילים לבדוק את הצהרות העניין שנשלחו על ידי כותבים טכניים שרוצים לעבוד על הפרויקט שלכם.
שלב הבקשה
- בוחרים את הרעיון הכי מבטיח מדף ההצעה. כל ארגון יכול לשלוח רק הצעה אחת. כמה דברים שכדאי להביא בחשבון:
- איזו רעיון עורר הכי הרבה עניין בקרב הכותבים הטכניים?
- איזו רעיון יעזור לכם לפתור את הבעיה הגדולה ביותר בפרויקט? עדיף לבחור רעיון מסוכן יותר שיש לו השפעה גדולה יותר, מאשר רעיון לפרויקט תיעוד שיש סיכוי גבוה יותר להשלים אותו אבל לא ישנה באופן משמעותי את הפרויקט.
- האם הרעיון דורש השתתפות של חברים ספציפיים בקהילה? האם יש להם זמן להשתתף?
יוצרים את ההצעה באמצעות התבנית של ההצעה. חשוב להבין את הפרטים הבאים ולכלול אותם:
- הבעיה שרוצים לטפל בה
- היקף המסמך שרוצים לשפר או ליצור
- איך תמדדו את ההצלחה של התיעוד
ההצעה צריכה לכלול גם תקציב. לא נוכל לבדוק הצעות חלקיות.
שולחים את טופס הבקשה עד למועד האחרון להגשת בקשות, 2 באפריל 2024 בשעה 18:00 (שעון UTC). ההצעות שאושרו יפורסמו ב-10 באפריל 2024.
פיתוח פרויקטים ודיווח
האדמינים בארגון צריכים להבין מהן האחריותיות שלהם בכל שלב בתוכנית.
יציאה לדרך של פרויקט
- אם בארגון שלכם כבר בחרתם סופר/ת טכני/ת לפרויקט, כדאי לקיים פגישה ראשונית עם הסופר/ת הטכני/ת. כדאי לעבוד בשיתוף פעולה עם הכותבים הטכניים כדי ליצור לוח זמנים לעבודה ולקבוע מועדים קבועים לעדכונים.
- אם קיבלתם כמה הצהרות עניין ממגישים מתעניינים לכתיבה טכנית, כדאי להודיע באופן ציבורי על הבחירה שלכם במגיש המתאים או להודיע על ההחלטה שלכם בדרך אחרת.
תשלומי מענקים
- החל מ-11 ביוני 2024, תוכנית Google Season of Docs תפקיד 40% מסכום המענק בחשבון Open Collective של כל ארגון אחרי שהוא יקבל לעבודה סופר טכני. מומלץ לארגונים ליצור לוח זמנים לתשלומים עם הכותבים הטכניים על סמך אבני דרך בפרויקט, כולל תשלום בתחילת הפרויקט.
- 60% הנותרים יופקדו בחשבונות Open Collective של ארגונים שישלימו וישלחו את הבדיקות הסופיות ואת מקרי המחקר שלהם, החל מ-13 בדצמבר 2024. כל הפרויקטים שעומדים בדרישות יתחילו לקבל את התשלום הסופי ב-13 בדצמבר 2024
- מידע נוסף על יצירת חשבון ב-Open Collective זמין במדריך התשלומים.
דיווח על סטטוס הפרויקט
- האדמינים של הארגון צריכים למלא את דוחות הסטטוס החודשיים תוך שבוע ממועד קבלת הקישור לטופס דוח הסטטוס (הקישור יישלח באימייל, לכן אם לא ראיתם אותו, כדאי לבדוק בתיקיית הספאם).
הערכה סופית של הפרויקט ודוח מקרה לדוגמה
כדי לקבל את יתרת סכום המענק, הארגונים צריכים להשלים ולשלוח את הבדיקה הסופית של הפרויקט ואת ניתוח המקרה לפני 10 בדצמבר 2024 בשעה 18:00 (שעון UTC).
הערכה סופית
הטפסים של הסקירה הסופית ושל מחקר המקרה יהיו זמינים לאדמינים ארגוניים לפחות חודש לפני 10 בדצמבר 2024 בשעה 18:00 (שעון UTC).
מקרה לדוגמה
מקרה המחקר ב-Google Season of Docs הוא המסמך העיקרי שעליכם לספק כחלק מהשתתפות הארגון שלכם ב-Google Season of Docs. כדאי לנהל יומן שבועי של עדכוני הפרויקט כדי לעזור לכם ליצור את ניתוח המקרה. בכל שבוע, כדאי לתעד את התקדמות הפרויקט (כולל קישורים לבקשות משיכה, לבעיות או לשיחות, במקרים הרלוונטיים), מה הלך טוב (או לא טוב), מה למדתם ושאלות שנשאלו.
למידע נוסף, אפשר לקרוא את המאמר יצירת מקרה לדוגמה. חשוב לפעול לפי התבנית של המקרה לדוגמה כדי ליצור את המקרה לדוגמה. עליכם לשלוח את דוח המחקר כקישור בטופס דוח המחקר.
ניתוח המקרה יפורסם באתר של Google Season of Docs, לכן חשוב לזכור זאת כשאתם מוסיפים מידע על הפרויקט.
סקרים עוקבים
הארגונים שאושרו נדרשים להשתתף לפחות בשלושה סקרים עוקבים כדי לעזור לנו לעקוב אחרי ההצלחה של הפרויקטים של Google Season of Docs לאורך זמן. הסקרים הבאים הם המפתח להבנת ההשפעה של Google Season of Docs.
טפסים
| טופס | קישור | תאריך יעד |
|---|---|---|
| בקשת הצטרפות של ארגון |
האפליקציות של הארגון סגורות עכשיו. כדי להתעדכן, כדאי להצטרף לרשימת התפוצה של ההודעות בכתובת season-of-docs-announce. |
2 באפריל 2024 בשעה 18:00 (שעון UTC) |
| פרטי התשלום של הארגון |
השלמת השלב של פרטי התשלום של הארגון. אם אתם צריכים לבצע שינויים בפרטי התשלום של הארגון, תוכלו לפנות לאדמינים של Season of Docs. |
22 במאי 2024 בשעה 18:00 (שעון UTC) |
| הוכחה לכך ששכרתם סופר טכני |
שלב הגיוס של סופר טכני הושלם. |
22 במאי 2024 בשעה 18:00 (שעון UTC) |
| הערכות חודשיות |
שלב הבדיקה החודשי הסתיים. |
ציר הזמן |
| הגשת מקרה לדוגמה | 10 בדצמבר 2024 בשעה 18:00 (שעון UTC) | |
| הערכה סופית של התוכנית | 10 בדצמבר 2024 בשעה 18:00 (שעון UTC) | |
| סקרים עוקבים |
הטופס יהיה זמין במהלך השלב של הסקרים הבאים (1 במאי 2025). |
ציר הזמן |