שאלות נפוצות

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

כללי

האם Google Season of Docs היא תוכנית גיוס?

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

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

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

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

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

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

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

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

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

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

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

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

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

  • יצירת הדרכה לתרחיש שימוש חשוב.

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

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

האם סרטון יכול להיחשב כפרויקט ב-Google Season of Docs?

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

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

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

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

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

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

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

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

איפה מתקיים Google Season of Docs?

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

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

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

האם אפשר להוסיף את ציר הזמן של Google Season of Docs ליומן?

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

מה אפשר לעשות כדי לעזור להפיץ את המידע על 'עונת המסמכים של Google'?

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

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

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

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

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

האם אקבל חולצה של Google Season of Docs?

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

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

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

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

איך אפשר להיות מנטור בתוכנית Google Season of Docs?

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

האם Google Season of Docs דומה ל-Google Summer of Code?

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

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

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

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

אילו כלים ותבניות לתיעוד כדאי להכיר כדי להשתתף ב-Google Season of Docs?

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

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

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

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

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

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

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

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

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

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

האם אקבל תשלום על ההשתתפות ב-Google Season of Docs?

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

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

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

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

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

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

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

אני תלמיד/ה. האם אוכל להשתתף ב-Google Season of Docs? האם תוכנית Google Season of Docs תעזור לי להפוך לכותב טכני?

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

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

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

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

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

אפשר ליצור קשר עם האדמינים של תוכנית Google Season of Docs ב-Google באמצעות אימייל לכתובת [email protected].

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

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

איך אפשר לציין את Google Season of Docs בקורות החיים?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הארגון שלנו השתתף בתוכניות קודמות של Google Season of Docs. האם יש לנו אפשרות להגיש שוב בקשה?

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

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

איך מסירים את הפרטים מהארכיון של Google Season of Docs?

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