פרויקט INCF

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

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

ארגון קוד פתוח:
INCF
כותבים טכניים:
Ogbonoko
שם הפרויקט:
The Turing Way: מדריך למדעי הנתונים
אורך הפרויקט:
אורך סטנדרטי (3 חודשים)

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

מבוא

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

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

יעדי הפרויקט

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

  • בודקים את הפרקים הקיימים של The Turing Way ומחפשים דרכים לשפר את השפה והמבנה שלו,

  • שילוב תוכן חדש בתוכן הקיים, תוך שמירה על העקביות של הסגנון והנימה הכללית של The Turing Way, וגם

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

ציר הזמן

אם הבקשה שלי תאושר, אני מציע להשלים את הפרויקט באופן הבא:

עד 17 באוגוסט:

לתרום ל-The Turing Way כשהדבר אפשרי (תיקון שגיאות הקלדה וכו')

להכיר את המידע הנוכחי שמופיע ב-The Turing Way

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

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

משתתפים באופן יזום עם הצוות/הקהילה שמאחורי The Turs Way ולומדים על הפרויקט.

ליצור ערוצי תקשורת עם המנטורים ולשמור עליהם.

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

שבוע 1 (14 בספטמבר עד 19 בספטמבר)

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

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

אתחיל את שלב הגהה עם הפרק Guide for Reproducible Research (מדריך למחקר שניתן לשחזור).

שבוע 2 (20 בספטמבר עד 26 בספטמבר)

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

שבוע 3 (27 בספטמבר עד 3 באוקטובר)

קוראים ומעריכים את הפרק 'מדריך לתקשורת'.

שבוע 4 (4 באוקטובר עד 10 באוקטובר)

קוראים ומעריכים את הפרק 'מדריך לשיתוף פעולה', ומוסיפים תוכן חדש.

שבוע 5 (11 באוקטובר עד 17 באוקטובר)

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

שבוע 6 (18 באוקטובר עד 24 באוקטובר)

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

שבוע 7 (25 באוקטובר עד 31 באוקטובר)

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

שבועות 8 עד 10 (1 בנובמבר עד 28 בנובמבר)

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

שבוע 12 (29 בנובמבר עד 5 בדצמבר)

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