שאלות נפוצות

השלב הנוכחי:
תוכנית 'עונת 2020 של Docs' הסתיימה ב-15 במרץ 2021. אפשר לראות את ציר הזמן.

כללי

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

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

האם עונה של Docs נחשבת להתמחות, למשרה או לכל סוג תעסוקה?

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

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

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

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

יתרונות לארגוני קוד פתוח:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

כן. כותבים ומנטורים טכניים בפרויקטים שהושלמו יקבלו חולצת טישרט של Docs בעונה.

מתי החולצה שלי תגיע?

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

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

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

אם אחרי שתקראו את כל המסמכים עדיין לא מצאתם תשובה, כדאי לדון בשאלות עם קהילת Docs ב-Slack או עם רשימת הדיון. קראו על ערוצי דיון והסבר על יצירת קשר.

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

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

שלב הבקשה לכתיבה טכנית פועל מ-9 ביוני 2020 עד 9 ביולי 2020. עיינו בציר הזמן של התוכנית ובמדריך הטכני לכתיבה.

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

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

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

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

באילו שפות תכנות עלי לדעת כדי להשתתף ב'עונה של Docs'?

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

האם אפשר להגיש יותר מהצעה אחת לפרויקט?

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

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

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

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

לא, רק אדם אחד יכול לעבוד על פרויקט נתון.

האם אפשר ליצור קשר ישירות עם ארגוני החונכות לפני ששולחים הצעה לעונה של Docs?

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

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

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

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

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

אילו טפסים אצטרך לספק?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

לפרטים נוספים, פנו למשרד הסטודנט הבינלאומי בבית הספר שלכם. Google לא יכולה לספק לך הרשאה מסוג CPT או opt (הסכמה).

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

איך התכונה 'עונה של Google Docs' משתמשת במידע מטופס הבקשה שלי?

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

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

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

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

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

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

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

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

מהן דרישות הסף לארגון חונכות?

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

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

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

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

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

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

איך מנהלי התוכנית של Google מקצים משבצות לפרויקטים של כתיבה טכנית?

בעונה של 2020 ב-Docs ניתן להוסיף עד 50 פרויקטים טכניים של כתיבה.

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

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

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

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

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

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

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

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

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

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

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

האם אוכל להשתתף ב-עונה של Google Docs גם כמנהל ארגון וגם כמנטור?

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

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

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

האם אוכל להשתתף כמנהלי חשבון ארגוני או כמנטור גם בעונת Docs וגם ב-Google Code-in?

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

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

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

צור איתנו קשר כדי להסיר את הפרטים שלך.