פרויקט LibreOffice

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

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

ארגון הקוד הפתוח:
LibreOffice
כתב טכני:
קרז'אירו
שם הפרויקט:
חומר עזר ומדריך למשתמש בנושא פונקציות Calc
אורך הפרויקט:
אורך רגיל (3 חודשים)

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

בקשת פרויקט

אני יכולה להקדיש בקלות 30-35 שעות בשבוע במהלך שלב הכתיבה הטכנית, ו-10-12 שעות בשלב טרום-הכתיבה כדי ללמוד כל תוספת על המיומנות הנחוצה לפרויקט. רציתי לעדכן אותך שכרגע אנחנו גרים באוניברסיטה שלי (במדינת המקור שלי), שבה יש לי גישה לאינטרנט מהיר ולכל מקורות מידע נוספים שדרושים לצורך הפרויקט. אני אמשיך מהאוניברסיטה עצמה למשך כל תקופת הפרויקט בגלל נגיף הקורונה (COVID-19), אבל אני לא רואה את האוניברסיטה שלי בזמן הקרוב, וגם אם זה יקרה בשנה האחרונה, שבו הפרויקט אמור להשתתף עד 5 שעות, אבל לא תהיה לי יותר אפשרות להשתתף בה.

מבוא

ל-LibreOffice Calc יש רשימה מקיפה (+ 500) של פונקציות בקטגוריות רבות שבהן התיעוד די רדוד (אך עם זאת מדויק) בעזרה. אשף הפונקציות המובנה של חשבון Cloud מספק למשתמש גם סיכום של המטרה והפרמטרים של כל פונקציה. נוצר מבנה ב-wiki של The Document Foundation כדי לתעד מידע מפורט יותר על הפונקציות של Calc.

יעד

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

תוכנית עבודה של פרויקט

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

מומלץ לחלק את הפונקציות האלה לפי קטגוריות:

• Database: This section deals with functions used with data organized as one row of data for one record. 
• Date & Time: These spreadsheet functions are used for inserting and editing dates and times.
• Financial: This category contains the mathematical finance functions of LibreOffice Calc.
• Information: This category contains Information functions.
• Logical: This category contains Logical functions.
• Mathematical: This category contains the Mathematical functions for Calc.
• Array: This category contains the array functions.
• Statistical: This category contains Statistics functions.
• Spreadsheet: This section contains descriptions of the Spreadsheet functions together with an example.
• Text: This section contains descriptions of the Text functions.
• Add-in: The following describes and lists some of the available add-in functions.

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

אני רוצה להוסיף תוכן מפורט יותר לכל אחת מהפונקציות של Calc, ולסמן את התאימות לתקן ODFF, כולל איורים ודיאגרמות בכל מקרה שבו הדבר שימושי, לתת דוגמה אחת או שתיים שממחישות מקרים של פינות וחריגות בצורת הערות, וכן מספק קבצים לדוגמה/דוגמאות. הוספת קטע חשוב גם אם הוא שימושי. אני אשקול לעבור על הפונקציות האלה בפורמט חד-משמעי, כלומר להשתמש באחת מהן ולעבוד במאונך ואז לעבור לקטגוריה אחרת במהלך תקופת הכתיבה הטכנית. בנוסף, הייתי רוצה להתרגל לסביבת העבודה בתקופת החיבור של הקהילה כדי שיהיה קל יותר בשלב הכתיבה. מניסיוני, הגילוי של כל רגעי ה"gotcha" הקטנים והרבים של תיעוד סוגי האפליקציות האלה מצריכים השקעת זמן. מבחינה תכנון, בהתחלה הייתי ניגשת לפרויקט באמצעות הרצה של 11 הקטגוריות האלה לעבודה. כמובן שחלקן יזדקקו לעזרה נוספת, ולכן הן יחייבו יותר זמן מאחרים, אבל ניתן לטפל בבעיות האלה תוך כדי העבודה. מכיוון שכבר יש תיעוד, ואני כותב עליו, אשקול לבצע הגהה לאחר כל משימה של שבוע כי לא מומלץ להשאיר אותה לשבוע האחרון.

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

  • שבוע 1:(14 בספטמבר) • מסד נתונים
  • שבוע 2:(21 בספטמבר) • תאריך ושעה
  • שבוע 3:(28 בספטמבר) • מידע פיננסי
  • שבוע 4:(5 באוקטובר) • מידע
  • שבוע 5:(12 באוקטובר) • לוגי
  • שבוע 6:(19 באוקטובר) • מתמטיקה
  • שבוע 7:(26 באוקטובר) • מערך
  • שבוע 8:(2 בנובמבר) • נתונים סטטיסטיים
  • שבוע 9:(9 בנובמבר) • גיליון אלקטרוני
  • שבוע 10:(16 בנובמבר) • הודעת טקסט
  • שבוע 11:(23 בנובמבר) • תוספת
  • שבוע 12:(30 בנובמבר עד 5 בדצמבר)(סופי)

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