הפרויקט של Linux Foundation

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

סיכום הפרויקט

ארגון קוד פתוח:

The Linux Foundation

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

jaskiratsingh2000

שם הפרויקט:

CHAOSS: יצירת מדריך לקהילה של CHAOSS

אורך הפרויקט:

אורך סטנדרטי (3 חודשים)

תיאור הפרויקט

תקציר הפרויקט:

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

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

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

מה צריך בשביל זה?

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

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

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

תיאור הפרויקט:

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

• מבוא
• הדרך של קהילת CHAOSS
• הדרך לניהול
• הסברים על המונחים
• הנחיות לתרומת תוכן
  • מפתח
  • Designer
  • Writer
  • משווק
• מדדים
• CHAOSScon
• CHAOSScast
• סרטוני פגישות
• שאלות נפוצות כלליות
• חונכות
  • קיץ של Google בקוד
  • Outreachy
  • Google Season of Docs

פרטים על תוצרים של פרויקטים

1.) מבוא:

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

A.) הוא יכיל את הודעת הפתיחה עם תיאור קצר של קהילת CHAOSS, שיעזור לשכנע את הקוראים לקרוא את המדריך. אצרף גם את הקולאז' של התמונות שמוצג כאן: https://chaoss.community/chaoss-photo-album/, שמבליט את התנועות השונות בקהילה. B.) הדף יכלול גם את הפרטים של כל הקטעים, עם תיאור של שורה אחת שמסביר כל קטע וקישורים מתאימים. C.) שימוש במדריך: השימוש במדריך כבר קיים כאן( shorturl.at/cqQU6 ), אבל אחדש ואשפר את השימוש הקיים במדריך באמצעות קוד markdown משופר, שיכלול את התהליך של השימוש במדריך(אציין איך דברים מתרחשים כשמישהו רוצה להוסיף, להסיר או לדון בנושאים שקשורים למדריך. יכול להיות שהם ימשיכו את תהליך התקשורת בכל מה שקשור למדריך.), הנחיות למדריך (כולל השימוש בו בקהילה וההיקף שלו), תרומה למדריך (כולל הוראות לשימוש במאגר כדי לבצע שינויים, לשלוח בקשות לשינוי קוד (PR) ולבצע שינויים במדריך ובמדריך הסגנון) ושיתוף משוב על המדריך. בקטע 'שיתוף משוב', אכלול תבנית ודרכים שונות שבהן המשתמשים יכולים לפנות אלינו כדי לקבל משוב או להשתמש בבעיות ב-GitLab.

2.) הדרך של קהילת CHAOSS:

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

A.) ערכים כלליים: תיאור האופן שבו קהילת CHAOSS מטפלת בנושאי קיימות, פתיחות ושקיפות. אסביר על הערכים האלה ואנסה להבהיר למשתמשים החדשים או הקיימים איך להבין אותם ולקחת אותם בחשבון כשהם עובדים בקהילה. B.) הנחיות הקהילה: כאן מוסבר איך להשתתף בקהילה של CHAOSS ולפעול בהתאם לתנאים הבסיסיים. נסביר גם על תרבות העבודה שבתוך הקהילה. (מה צריך לעשות ומה לא לעשות). התוכן יכלול את רשימת המשימות העיקריות לתורמים/לתחזוקה, וגם יעזור לאחרים לדעת איך כדאי להם לעבוד עם האחראים לתחזוקה ומהי רשימת המשימות שלהם. C.) קבוצות עבודה: הדף הזה( https://chaoss.community/participate/ ) מכיל מידע על קבוצות העבודה, כמו תיאור של קבוצת העבודה, קישור למאגר ופרטים על הפגישות. אבל במדריך אציג גם איך להשתתף בקבוצות העבודה השונות, איך להבין את תהליך הערכת המדדים, איך להבין את תרבות העבודה של כל קבוצת עבודה ואיך להפוך לתורמים מרכזיים בקבוצות עבודה שונות.

3.) הדרך לקבלת תפקיד מנהיג:

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

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

4.) מונחים:

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

5) הנחיות לתרומת תוכן:

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

A.) הבנת מפת הדרכים של הקהילה: נושא זה יוביל לסקירה כללית של מפת הדרכים של קהילת CHAOSS, שתסייע למשתמשים לדעת באיזו דרך או תהליך עליכם לפעול כדי לתת עדיפות לפעולות השונות בפרויקט CHAOSS. B.) הסבר על הדברים הנדרשים כדי לתרום באופן מעשי, כמו פיתוח, תיעוד, עיצוב, בדיקה וכו' ג.) מתן סקירה כללית קצרה על אופן הפעולה של GitLab D.) מדריך לבודקים/למפתחים

הקטע הזה יכלול גם את 'התפקידים והאחריות' של כל קטגוריית תרומה, כפי שמפורט בהמשך:

a.) עיצוב: הקטע הזה יכלול את 'תהליך העבודה של CHAOSS לעיצוב' ואת הנחיות העיצוב, שיכללו את עקרונות העיצוב, התהליך והכלים שבהם משתמשים, והם יהיו מחייבים לתורמים בתחום העיצוב. ב.) פיתוח: כאן יפורסם המדריך לתרומה לקוד. הוא יכיל את הדרישות הטכניות, מבנה הפרויקט, הגדרת הפרויקט(Augur, ‏ Cregit, ‏ GremoireLab) ג.) מסמכים: המסמכים יכללו משאבים למסמכים, כולל כלים ומדריך סגנון. ד.) יצירת קשר עם קהלים: כאן נסביר איך שותפים יכולים לתמוך בקהילת CHAOSS בהרחבת היקף החשיפה שלה – כתיבת בלוגים, שימוש בכינויים ברשתות החברתיות, ארגון מפגשים ואירועים

6.) מדדים

נכון לעכשיו, אתר הקהילה של CHAOSS מכיל את המידע על גרסאות של מדדים( https://chaoss.community/metrics/ ), וחשוב יותר שאנשים יבינו איך לפעול לפי התהליך כדי להפוך את אתר המדדים שלהם לזמין באתר הזה. הקטע הזה יכיל מידע שיעזור למשתמשים להבין את התהליכים והעבודה הנדרשים כדי להשיק מדדים משלהם.

7.) CHAOSScon:

המידע על CHAOSScon כבר קיים ב-GitHub( https://github.com/chaoss/governance/blob/master/community-handbook/chaosscon.md ) ובאתר( https://chaoss.community/CHAOSScon-2020-NA/ ), אבל כדאי יותר להוסיף את הפרטים והמידע שמסבירים את התהליכים והדרכים לנהל אותם ב-CHAOS. המדריך מכיל את המידע הבא:

A.) פרטים על הוועדה המארגנת: נסביר על התהליכים של אופן ההשתתפות בוועדה המארגנת של CHAOSScon ב.) ניהול תהליך הקריאה להגשת הצעות: התפקיד הזה יכלול ניהול הרישום של המחברים, שליחת הצעות ותיעוד, תהליך הבדיקה והאישור. C.) ניהול ופרסום של תוכנית CHAOSScon D.) איך לנהל את הנושאים של פרסום ושיווק E.) איך מטפלים בהצעות ובכספים של חסויות, כולל חבילות

8.) CHAOSScast:

המידע על CHAOSScast זמין בכתובת https://github.com/chaoss/governance/blob/master/community-handbook/chaosscast.md, והוא ייכלל במדריך עם פרטים נוספים כמו השתתפות, ועדת ארגון, פרסום וחומרים שיווקיים.

9.) סרטוני הפגישות:

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

10.) שאלות נפוצות כלליות:

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

11.) Google Summer of Code:

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

1. Outreachy:

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

1. Google Season of Docs:

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

התוצאה הצפויה של הפרויקט:

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

פרטים טכניים:

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

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

הנה כמה תמונות שנותנות הצצה לפלטפורמה

• shorturl.at/GNQR4
• shorturl.at/gATZ8
• shorturl.at/qrE57
• shorturl.at/rFRX6
• shorturl.at/eyLW1
• shorturl.at/rwHS8

-- איפה יתארח המדריך?

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

דומיינים מותאמים אישית: אם קהילת CHAOSS רוצה לארח את האתר בדומיין מותאם אישית, הוא יוצג כך: docs.chaoss.community. הארגון צריך רק ליצור תת-דומיין כלשהו שהוא רוצה. כדי להגדיר את הדומיין של הארגון, עוברים להגדרות הארגון בפלטפורמת Gitbook. דוגמה לקישור תמונה: shorturl.at/GNQR4

מרחבים ב-GitBook מוצגים ב-CDN שלנו, ו-HTTPS מופעל כברירת מחדל. האישורים מונפקים על ידי LetsEncrypt

דומיינים נתמכים:

• תת-דומיין: www.example.com
• דומיין מותאם אישית: docs.example.com

-- איך מסנכרנים את Gitbook עם GitHub כדי שיהיה אפשר לערוך ביעילות בשתי הפלטפורמות?

קל מאוד להשתמש בשילוב עם GitHub: אם מישהו משנה תוכן ב-GitBook, העריכות שלו מועברות למאגר ב-GitHub. לעומת זאת, השמירות (commits) שנדחפו למאגר ב-GitHub מיובאות בתוך GitBook.

מגדירים את השילוב עם GitHub:

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

לאחר השלמת השלבים האלה, GitBook יוסיף webhook למאגר chaoss-handbook שיאפשר לו לאחזר תוכן בכל שינוי במאגר. כשמבצעים שינויים ב-GitBook, תגובת הערה חדשה תישלח.

זהו! כל אחד יכול להמשיך לערוך את המסמך מ-GitBook או מהמאגר ב-GitHub.

-- איך עורכים דפים בפלטפורמה של GitBook?

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

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

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

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

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

דוגמאות לקישורים לתמונות: shorturl.at/gATZ8 ו-shorturl.at/qrE57

-- מבנה התוכן:

תוכן עניינים: כל מרחב יכול להכיל כמה דפים שצריך כדי לכתוב את המסמכים. כל הדפים האלה מוצגים בצד ימין של המסך, במה שאנחנו מכנים 'תוכן עניינים'. תוכלו להשתמש בתוכן העניינים כדי לנהל את הדפים: ליצור דפים חדשים, ליצור קבוצות של דפים, להוסיף קישורים חיצוניים, להוסיף וריאנט, לייבא מסמכים חיצוניים כמו אתרים או קבצים בפורמט Markdown‏ (‎.md או ‎ .markdown), HTML‏ (‎.html) או Microsoft Word‏ (‎.docx).

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

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

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

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

דוגמה לתמונה: Shorturl.at/eyLW1 ו-shorturl.at/rFRX6

-- איך המדריך יוצג בצד הלקוח?

אפשר יהיה לגשת למדריך הקהילה של Chaoss באמצעות תת-דומיין, למשל https://docs.chaoss.community. המדריך ייראה כך בקצה המשתמש:

• המדריך של Mattermost – https://handbook.mattermost.com/
• מסמכי גישור של קהילת Linux Foundation – https://docs.linuxfoundation.org/docs/ ועוד רבים אחרים

לוח הזמנים של הפרויקט:

1.) שלב יצירת הקשרים בקהילה (17 באוגוסט עד 13 בספטמבר)

A.) שבוע 1-4:

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

2.) שלב פיתוח המסמך (14 בספטמבר עד 30 בנובמבר)

A.) שבוע 5 (14 בספטמבר עד 20 בספטמבר)

• הקטע 'מבוא' בטיוטה

B.) שבוע 6 (21 בספטמבר עד 27 בספטמבר)

• טיוטה של הקטע 'הדרך של קהילת CHAOSS'

C.) שבוע 7 (28 בספטמבר עד 4 באוקטובר)

• ניסוח הקטע 'הדרך לניהול'
• כתיבת טיוטה של הקטע 'הסבר על המונחים'

D.) שבוע 8 (5 באוקטובר עד 11 באוקטובר)

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

E.) שבוע 9 (12 באוקטובר עד 18 באוקטובר)

• הקטע 'פיתוח טיוטה'

F.) שבוע 10 (19 באוקטובר עד 25 באוקטובר)

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

G.) שבוע 11 (26 באוקטובר עד 1 בנובמבר)

• הקטע 'טיוטת מדדים'
• טיוטה של קטע בנושא CHAOSScon

H.) שבוע 12 (2 בנובמבר עד 8 בנובמבר)

• עיצוב הקטע 'פגישה'

• טיוטה של שאלות נפוצות כלליות של הקהילה

  I.) שבוע 13 (9 בנובמבר עד 15 בנובמבר)

• טיוטה לגבי ההנחיות של GSoC

J.) שבוע 14 (16 בנובמבר עד 22 בנובמבר)

• טיוטה לגבי הנחיות Outreachy

K.) שבוע 15 (23 בנובמבר עד 29 בנובמבר)

• זמן לליטוש ושיפור של כל המסמכים

3.) שלב ההערכה (30 בנובמבר עד 5 בדצמבר)

A.) שבוע 16:

• כתיבת טיוטה של דוח פרויקט
• מילוי הערכת הפרויקט

אינטראקציות בקהילה

1.) מעורבות וקבוצות דיון עם הקהילה.

אני גולש בקהילה של CHAOSS מאז אפריל 2020, והשתתפתי בדיונים שונים עם חברי הקהילה ועם המנטורים הספציפיים שלי בפרויקט( Georg Link ו-Armstrong Foundjem). אחת מהדיונים האלה שעוררו עניין רב בקרב חברי הקהילה הייתה'הצעה ל-Gitbook כפלטפורמה לאירוח מדריך הקהילה'. אפשר למצוא את השרשור הזה ברשימה הארכיונית של CHAOSS, בשם Proposing Gitbook as a platform for hosting Community Handbook. השתתפתי גם בשיחות השבועיות של הקהילה, וזה עזר לי לספק עדכונים לקהילה.

2.) איך תאספו את המידע הנדרש לפרויקט הזה?

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

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

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

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

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

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

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

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

4.) מה תעשה אם תקלע לבעיה בפרויקט והמנטור לא יהיה זמין?

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

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

בנוסף, כדאי להשתתף בשיחות השבועיות של קהילת CHAOSS כדי לשאול שאלות.