שאלות נפוצות

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

כללי

האם עונה של Docs היא תוכנית גיוס עובדים?

לא. אם אתם רוצים לעבוד ב-Google, היכנסו אל אתר המשרות של Google.

מה ההבדל בין התוכנית הנוכחית לבין העונה של Docs 2019 ו-2020?

העונה הנוכחית של תוכנית Docs כוללת שינויים משמעותיים משנים קודמות, כולל:

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

מדוע העונה של Docs ביצעה את השינויים האלה?

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

הארגון שלנו רוצה להשתתף ב'עונה של Google Docs', אבל אנחנו לא יודעים מאיפה להתחיל!

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

אילו סוגי פרויקטים ארגונים יכולים להציע?

רעיונות לשינויים:

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

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

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

  • ליצור מדריך לתרחיש לדוגמה בעל פרופיל גבוה.

  • יוצרים קבוצת מדריכים ממוקדים למשימות ספציפיות.

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

האם סרטון הוא פרויקט אפשרי לעונה של Google Docs?

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

האם ביקורת תיעוד היא פרויקט סביר לעונה של Google Docs?

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

האם יש תבניות מסמכים שאפשר להשתמש בהן לארגונים ולכותבים טכניים?

לעונה של Docs יש מאגר GitHub עם תבנית ורשימת משימות לביצוע ביקורות מסמכים. אנחנו מקווים להוסיף תבניות נוספות ברגע שהן נוצרות.

אנחנו פועלים כדי ליצור כמה תבניות תיעוד מינימליות לשימוש בקוד פתוח ב-The Good Docs Project.

האם ארגונים נדרשים להשתמש במסמכים שהופקו על ידי כותבים טכניים?

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

איפה מתרחשת העונה של Docs?

העונה של Docs מתרחשת לחלוטין באינטרנט. אין חובה לנסוע כחלק מהתוכנית.

איך אפשר להתעדכן לגבי העונה של Docs?

לקבלת עדכונים והודעות בקשר לעונה של Docs, כדאי להיכנס לרשימת התפוצה של סוף השנה האזרחית בכתובת season-of-docs-announce. מצטרפים לקבוצה ומקבלים עדכונים באימייל.

האם אפשר להוסיף ליומן שלי את העונה של ציר הזמן ב-Docs?

כן, אפשר להוסיף אותם באמצעות הקישור הזה.

מה אוכל לעשות כדי להפיץ את השמועה על עונה של Google Docs?

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

כיצד מארגנים או מארחים עונה של פעילות מידע או מפגש בנושא Google Docs?

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

האם יש נתונים סטטיסטיים שאפשר לשתף על העונות של Docs 2019 ו-2020?

כן, כאן אפשר לראות את התוצאות של תוכנית Docs לשנת 2020, וכאן אפשר לראות את התוצאות של התוכנית לשנת 2020.

האם אקבל עונה של חולצת טישרט של Docs?

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

למי אפשר לפנות אם יש עוד שאלות?

מומלץ לקרוא את המדריך לאדמינים בארגון ואת המדריך הטכני לכתיבה.

אם לאחר שקראת את כל התיעוד עדיין אין לך תשובה, תוכל לדון בשאלות שלך עם קהילת 'עונה' של Google Docs ברשימת הדיונים. קראו על ערוצי דיון והסבר על יצירת קשר.

איך אני יכול להיות מנטור לעונה של Google Docs?

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

האם עונה של Docs היא כמו Google Summer of Code?

לא. עונה של Docs מיועדת לאנשים עם ניסיון טכני מסוים בכתיבה, היא לא מיועדת כתוכנית חונכות כמו Google Summer of Code.

לכותבים טכניים

מתי יכולים כותבים טכניים להגיש בקשה לעונה של Docs?

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

אילו כלי תיעוד ומסגרות עליי להכיר כדי להשתתף ב-עונת המסמכים של Docs?

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

עם זאת, רוב ארגוני הקוד הפתוח משתמשים ב-Markdown או בשפת סימון אחרת בתיעוד שלהם. מומלץ לבדוק באיזו שפה משתמש הארגון שלכם ולהכיר את התחביר. Markdown הוא התחלה טובה, כי קובצי README של GitHub משתמשים בסגנון של Markdown. למידע נוסף: המדריך של GitHub ל-Markdown.

כדאי לבדוק אם הארגון שבחרתם כבר מארח את התיעוד שלו באתר, ואם כן, באיזו פלטפורמה הוא משתמש. הפלטפורמה יכולה להיות מחולל אתרים סטטי כמו Jekyll, Sphinx או Hugo, או שהארגון יכול לארח את המסמכים שלו ב-Read the Docs או ב-GitHub Pages. אחרי שתבדקו באיזו פלטפורמה הארגון משתמש, בדקו את השפה והמסגרת הרלוונטיות וערכו ניסויים. כך תוכלו להתחיל במהירות לעבוד על פרויקט הקוד הפתוח שלכם, ולהציב אתכם במקום טוב שבו תוכלו לתת ייעוץ ברור לפרויקט הקוד הפתוח שבחרתם.

באילו שפות תכנות עלי לדעת כדי להשתתף ב'עונה של פרויקטים ב-Docs'?

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

האם כותבים טכניים שכבר עובדים על פרויקט קוד פתוח יוכלו להמשיך לעבוד עליו כחלק מעונה של Docs?

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

מהן דרישות הסף להשתתפות בתוכנית?

האם צריך ניסיון או הכשרה קודמים ככותבים טכניים?

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

האם אקבל תשלום על ההשתתפות בעונה של Docs?

כן. Google תעניק מענקים לארגונים שהתקבלו כדי להשתמש בהם כדי להעסיק כותבים טכניים.

איך נראית הצהרת עניין טובה של כותב טכני?

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

כמה זמן נמשך ההשתתפות ב'עונה של Google Docs'?

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

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

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

האם סטודנטים יכולים להשתתף בעונה של Docs? האם עונה של Docs מלמדת אותי להיות כותב טכני?

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

האם אוכל להשתתף גם ככותבים טכניים ב-עונה של Docs וגם כתלמיד ב-Google Summer of Code?

למרות שכרגע זה לא מנוגד לכללים, אנחנו ממליצים מאוד שתלמידים שהתקבלו ל-Google Summer of Code לא יחולו על עונה של כתב טכני ב-Docs. על התלמידים להתרכז בעבודה של Google Summer of Code במקום להגיש בקשה ל-עונת המסמכים של Docs.

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

ככותב/ת טכני, כיצד אוכל ליצור קשר עם מנהלי מערכת של תוכנית Google Docs בנוגע לעונה של שאלות או בעיות נוספות?

כדי ליצור קשר עם מנהלי המערכת של תוכנית Google Docs ב-עונת החגים, תוכלו לשלוח להם אימייל לכתובת SEASON-of-docs@google.com.

האם חברת כתיבה טכנית או חברת ייעוץ יכולים להשתתף בעונה של Docs?

כן, ארגונים יכולים לשכור חברה כדי לבצע את העבודה שצוינה בהצעה שלהם.

איך אפשר לציין את 'עונה של Google Docs' בקורות החיים שלי?

ציינו אותה כמו כל עבודה עצמאית אחרת. למשל, "עבד ככותב טכני עבור [שם הפרויקט] כחלק מהעונה של תוכנית Docs".

האם אתם מספקים אישורים על השלמת ההשתתפות בעונה של Docs?

אנחנו לא יכולים לשלוח אישורים או אישורים על השתתפות בפרויקט לכותבים טכניים.

לאדמינים ארגוניים של קוד פתוח

מהן דרישות הסף שארגון קוד פתוח צריך לעמוד בהן?

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

כדאי גם לעיין בדרישות הסף שמתוארות בכללי התוכנית ובתוכניות של הסנקציות ומידע על מדינות מטעם משרד האוצר של ארה"ב.

האם השם 'ארגון' מקביל לפרויקט קוד פתוח?

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

האם ארגון יכול לשלוח יותר מהגשת בקשה אחת?

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

האם קבוצת פרויקטים של קוד פתוח יכולה לשלוח הצעה יחד כדי לעבוד על פרויקט תיעוד יחיד?

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

איך הארגון שלי יקבל את הכספים?

כדי לקבל כספים, לארגון צריך להיות חשבון Open Collective.

האם ארגונים מקבלים כסף על ההשתתפות ב'עונה של Docs'?

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

האם Google מכסה את העמלות על עיבוד התשלומים?

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

איך הארגון שלי צריך לתקצב את העלות של כותבים טכניים?

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

האם הארגון שלי יכול להשתמש במענק העונה של Docs כדי לשלם לתורם קיים?

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

האם הארגון שלי יכול לעבוד עם כתיבה טכנית של תלמידים?

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

  • בני 18 ומעלה
  • הם רשומים לתוכנית או לקורס של כתיבה טכנית או תקשורת טכנית
  • יש להם גישה מוכחת להדרכה טכנית בכתיבה טכנית באמצעות התוכנית או הקורס שלהם

האם הארגון שלי יכול לעבוד עם יותר מכותב טכני אחד?

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

האם הארגון שלי יכול להעסיק חברת כתיבה טכנית שתעבוד על הפרויקט שלנו?

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

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

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

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

האם אפשר לבדוק בקשה מטעם הארגון לפני המועד האחרון להגשת בקשות?

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

איך כדאי לארגונים להגביל את ההצעות לפרויקטים?

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

האם אוכל להשתתף כאדמינים ארגוניים ב-עונת המסמכים של Docs וכמנטור ב-Google Summer of Code?

כן. העונה של Docs ו-Google Summer of Code הן תוכניות נפרדות. אם יש לכם את רוחב הפס הדרוש להשתתפות בשתי התוכניות, זה בסדר.

הארגון שלנו השתתף בעונה הקודמת של תוכניות Docs. האם יש לנו זכאות להגיש שוב בקשה?

כן, ארגונים שהשתתפו בעונה קודמת של תוכניות Docs זכאים להגיש שוב בקשה.

נתונים שהועברו לארכיון

איך אפשר להסיר את הפרטים שלי מארכיון העונה של Docs?

צרו איתנו קשר ולבקש שנסיר את המידע שלכם.