שאלות נפוצות

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

כללי

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

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

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

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

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

למה השינויים האלה נעשו ב-Google עונה של Google Docs?

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

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

כדאי להציץ ברשימת הרעיונות לפרויקטים המלאה שלנו. תוכלו גם לפנות לקהילת הכתיבה הטכנית (כדאי לנסות את הערוץ #googleanalytics-of-docs בערוץ Write the 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?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

האם העונה של 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?

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

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

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

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

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

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

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

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

האם אתם מספקים אישורים על השלמת ההשתתפות בעונת Google 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 month of Docs וכמנטור ב-Google Summer of Code?

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

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

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

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

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

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