פרויקט Kolibri

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

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

ארגון הקוד הפתוח:
קוליברי
כתב טכני:
דניאל ו'
שם הפרויקט:
תהליכי עבודה של תוכן קוליברי
אורך הפרויקט:
תקופה ארוכה (5 חודשים)

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

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

סקירה כללית

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

יעדים עיקריים

  1. יצירה של דף נחיתה למדריך שעוזר למשתמשים להחליט מהו תהליך העבודה המתאים ביותר לצרכים שלהם. דף הנחיתה הזה יתארח בפלטפורמת Read the Docs.

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

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

כלים לפרויקט

העבודה תתבצע באמצעות תוכנה להקלטת מסך. יש לי ניסיון עם Camtasia אבל עבדתי גם עם תוכנות חינמיות וזולות יותר. הסרטון לדוגמה שמקושר כאן (https://youtu.be/DkMP_VdGslU) נוצר באמצעות Flashback של Blueberry Software, שעבורה יש לי כרגע רישיון. אני אוסיף כתוביות באמצעות YouTube. דפי ההדרכה יתארחו באתר Read the Docs של Kolibri. ישלים טיוטת עבודה ב-Google Docs ואוכל לעזור בהמרה של קובצי טקסט ל-Markdown או ל-reStructuredText עבור המוצר הסופי.

ציר הזמן

הפרויקט הזה יהיה בהתאם להנחיות הפרויקט לטווח ארוך (26 שבועות בסה"כ, מ-2 באוגוסט 2019 עד 28 בפברואר 2020). אקדיש כ-10 שעות בשבוע להשגת היעדים המתוארים בהמשך. בנוסף ליעדים האלה, אשתתף בפגישות ובתקשורת של חונכים במהלך התקופה הזו, לפי הצורך. אני אעבוד עם המנטורים כדי להחליט מה הזמן הכי טוב לעשות זאת. ציר הזמן מתחלק בדרך כלל לקטעים של ארבעה שבועות, ובהם אצור מספר סרטונים, דפי הדרכה ותרגילים.

שבועות ראשון ושבועיים

יעדים:

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

שבועות 3 עד שש (רמה 1 – מדריכים למתחילים)

יעדים:

  • פיתוח תוכן ושיעורים ראשוניים לתהליך העבודה INSTALL-IMPORT/רמה 1. יצירת סרטונים לתהליכי ההורדה, ההתקנה, ההגדרה והייבוא. מאחר שהפונקציות INSTALL-IMPORT הן הבסיס לתהליכי עבודה רבים אחרים, והנפוצות ביותר הן אלה הנפוצות ביותר, נקדיש חלק גדול מהזמן להשלמת המדריכים והשיעורים האלה.
  • התמקדו בסוגי המיקומים של 'ייבוא', ופתחו גרפיקה שתדגים למשתמשים איך הם יכולים להשיג תוכן לדף הנחיתה (ערוצים ציבוריים שקיימים ב-Kolibri Studio).
  • פיתוח סרטונים ותכנים נוספים שיורחבו באמצעות INSTALL-IMPORT (עדכון הערוץ). אפשר גם להוסיף את ההרחבות האלה כמקורות נוספים או כקישורים למסמכי תיעוד קיימים.
  • אפשר לעבוד על כתוביות בכל סרטון.
  • "בודקים את הסרטונים" ומבקשים משוב ממקורות מידע זמינים בנוגע לנוחות השימוש. התהליך הזה כולל בדיקה חוזרת של התבנית לסרטונים וגיבוש התבנית לסרטונים עתידיים.

שבועות 7 עד עשרה (רמה 2 – מעלה תוכן)

יעדים:

  • התמקדות בשיעורים ובסרטונים בתהליך העבודה עבור הפרסונה של Studio מעלה הסרטונים.
  • השלמה של התיעוד והשיעורים עבור UPLOAD-publish-IMPORT.
  • ניתן לפתח כתוביות לכל סרטון.

שבועות 11 עד ארבע-עשרה (רמה 3 – 'רמיקס' ועורך של תוכן)

יעדים:

  • התמקדו בתהליכי העבודה הבאים וצרו תוכן של מדריך/שיעור: UPLOAD-EDIT-publish-UPDATE ו-EDIT-publish-UPDATE.
  • פיתוח כתוביות לסרטונים.

שבועות 15 עד 18

יעדים:

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

שבועות תשע עד עשרים ושתיים

יעדים:

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

שבועות עשרים ושלוש עד עשרים וחמישה

יעדים:

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

שבוע עשרים ושש

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

רכיבים של המדריך

דף הנחיתה של המדריך

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

דפי הדרכה ודפי שיעורים

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

סרטונים ומבנה

בסרטונים מתואר קונספט אחד. הסרטונים יתנו כיוון במהלך ביצוע הפעולה הזו במסך. סרטון לדוגמה זמין כאן: https://youtu.be/DkMP_VdGslU. הסרטון לדוגמה הזה מראה איך להשתמש באשף כלי ההגדרה.

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

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

מבנים לדוגמה

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

  • הורדה, התקנה והגדרה של מתקן Kolibri
  • ייבוא תוכן ב-Kolibri Studio – חשוב לשים לב שהסרטון יופנה על ידי תהליכי עבודה אחרים

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

שיעור 1 – העלאת תוכן ויצירת ערוצים ב-Kolibri Studio

יעדי משתמשים: בסוף השיעור הזה תדע כיצד לבצע את הפעולות הבאות:

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

סרטונים של שיעור משנה:

  • שיעור משנה 1 – יצירת ערוצים משלכם ב-Kolibri Studio וייבוא תוכן מערוצים ציבוריים קיימים (Khan Academy , PHET וכו'): סרטון 1 – ערוצי תוכן ציבורי (הצגת ערוצים בסטטוס 'גלוי לכולם' ב-Kolibri Studio) סרטון 2 – יצירת ערוץ סרטון 3 – ייבוא תוכן מערוצים קיימים סרטון 4 – פרסום הערוץ שלך והשגת האסימון הסודי סרטון 5 – ייבוא הערוץ שלך ל-Kolibri באמצעות האסימון הסודי
  • שיעור משנה 2 – העלאת ערוץ התוכן של המסמכים שלי: סרטון 1 – העלאת קבצים מ'המסמכים שלי' סרטון 2 – יצירת תרגילים משלכם

שיעור 2 – עריכה מתקדמת של ערוצים ב-Kolibri Studio

יעדי משתמשים: בסוף השיעור הזה תדע כיצד לבצע את הפעולות הבאות:

  • עריכת ערוצי תוכן ב-Kolibri Studio
  • ניהול ערוצי תוכן ב-Kolibri Studio

סרטונים של שיעור משנה:

  • שיעור משנה 1 – עריכת תוכן על ידי הוספת תרגילים, סידור מחדש של מבנה התיקיות ואפשרויות שיתוף פעולה (סרטון אחד)
  • שיעור משנה 2 – שימוש בפונקציות אחרות כגון מחיקה/העברה של תוכן (סרטון אחד)

שיעור 3 – פרסום ערוצי Kolibri Studio לשימוש ב-Kolibri ועדכון ערוצים

יעדי משתמשים: בסוף השיעור הזה תדע כיצד לבצע את הפעולות הבאות:

  • פרסום ערוץ ב-Kolibri Studio ופרסום מחדש אחרי שמוסיפים תוכן חדש
  • עדכון ערוץ
  • קבלת אסימון ערוץ לייבוא אל Kolibri (באמצעות קישור לסרטון הקודם בשיעור 1 שכולל את הפעולה הזו)

סרטונים של שיעור משנה:

  • שיעור משנה 1 – פרסום עדכונים בערוץ

    סרטון 1: פרסום מחדש של הערוץ סרטון 2: עדכון הערוץ ב-Kolibri אחרי הוספת תוכן