פרויקט FOLIO

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

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

ארגון קוד פתוח:
FOLIO
כותבים טכניים:
gallinita
שם הפרויקט:
הרחבת מסמכי התיעוד למשתמשי קצה של אפליקציות FOLIO
אורך הפרויקט:
Long running (5 months)

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

בפרויקט הזה, אני מתכנן ליצור ולעדכן את המסמכים של FOLIO שמיועדים למשתמש הקצה. FOLIO היא מערכת לניהול ספריות, ולכן משתמש הקצה הוא צוות הספרייה. נכון לעכשיו, הוויקי של FOLIO (https://wiki.folio.org/) מכיל מסמכי עזרה מסוימים, אבל הם מינימליים ולא בפורמט נוח לקריאה שנוצר תוך התחשבות בצוות הספרייה. המסמכים החדשים שייווצרו במסגרת הפרויקט הזה יתארחו בבסיס ידע ספציפי של מסמכי עזרה, שאפשר יהיה לגשת אליו מהאפליקציות של FOLIO. המסמכים האלה יכללו תהליכי עבודה שרלוונטיים למערכת ולמשתמשים בספרייה. קבוצה ראשונית של מסמכי עזרה תפורסם באתר, החל מהפונקציונליות של ספרייה וחדר לימודים. אני רוצה לתרום ככל האפשר למסמכי התיעוד במהלך הפרויקט הזה 'לטווח ארוך'.

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