שאלות נפוצות

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

כללי

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

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

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

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

בערוץ עונת המסמכים של

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

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

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

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

  • לקריאת המסמך
  • מחולל אתרים סטטי כמו Hugo, Jekyll, Sphinx ו-עוד
  • דפי GitHub

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

השתמש ב-http://goo.gle/2NeZVew כדי להירשם לעונה של יומן Google Docs.

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

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

איך מארגנים או מארחים מפגש או מפגש מידע על Google Docs?

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

יש לך נתונים סטטיסטיים על התוכניות של 2019 ושל 2020?

כן, אפשר לראות את התוצאות של Google Podcasts לתוכנית 2019 בבלוג הקוד הפתוח של Google (2019, 2020).

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

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

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

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

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

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

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

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

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

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

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

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

אילו כלי תיעוד ומסגרות צריך להכיר כדי להשתתף בעונת Google של Docs?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

תוכלו לפנות אל מנהלי התוכנית של Google Channel ב-Google Podcasts , על ידי שליחת אימייל להם לכתובת [e-mail].

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

לצערנו, Google Channel of Docs לא יכול לספק משוב על בקשת הארגון.

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

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

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

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

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

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

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

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

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