בדף הזה מופיעים הפרטים של פרויקט כתיבה טכנית שהתקבל בעונה של Docs ל-Google Docs.
סיכום הפרויקט
- ארגון קוד פתוח:
- LibreOffice
- כותבים טכניים:
- Krezhairo
- שם הפרויקט:
- מדריך למשתמש ומסמך עזרה בנושא פונקציות Calc
- אורך הפרויקט:
- אורך רגיל (3 חודשים)
תיאור הפרויקט
בקשה לפרויקט
יש לי אפשרות להקדיש בקלות 30-35 שעות בשבוע בשלב הכתיבה הטכנית ו-10-12 שעות בשלב שלפני הכתיבה כדי ללמוד כל מיומנות נוספת שנדרשת לפרויקט. רציתי להודיע לך שבימים אלה אני מתגורר באוניברסיטה שלי(במדינה שלי) שבה יש לי גישה לאינטרנט מהיר לכל משאב נוסף שנחוץ לפרויקט. אמשיך לעבוד מהאוניברסיטה במשך כל תקופת הפרויקט, כי לא נראה לי שהאוניברסיטה תתחיל לפעול בקרוב בגלל המצב של נגיף הקורונה. גם אם היא תתחיל לפעול, אהיה בשנה האחרונה שלי ואצטרך להשתתף בשיעורים רק 5-6 שעות בשבוע, כך שהפרויקט לא יושפע מכך בשום צורה.
מבוא
ב-LibreOffice Calc יש רשימה מקיפה (יותר מ-500) של פונקציות בקטגוריות רבות, והתיעוד שלהן בעזרה הוא שטחי למדי (אבל מדויק). בנוסף, אשף הפונקציות המובנה של Calc מספק למשתמש מידע מסכם על המטרה והפרמטרים של כל פונקציה. נוצר מבנה בוויקי של 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, לכלול איורים ותרשימים במקרים שבהם הם מועילים, לספק דוגמה אחת או שתיים כדי לציין מקרים קיצוניים וחריגים בצורת הערות, ולספק קובצי דוגמה. בנוסף, הוספנו קטע חשוב בכל מקום שבו הוא רלוונטי. אנסה לעבור על הפונקציות האלה בפורמט קטגוריאלי, כלומר לבחור אחת ולעבוד אנכית, ואז לעבור לקטגוריה אחרת במהלך תקופת כתיבת המאמרים הטכניים. כדאי להתרגל לסביבת העבודה במהלך תקופת החיבור לקהילה כדי להקל על העבודה בשלב הכתיבה. מניסיוני, כדי לגלות את כל ה"הפתעות" הקטנות בתיעוד של אפליקציות מהסוגים האלה, צריך להשקיע זמן. מבחינת תכנון, בהתחלה הייתי מתייחס לפרויקט על ידי עבודה על 11 הקטגוריות האלה. כמובן, בחלק מהן תצטרכו עזרה רבה יותר, ולכן יידרש זמן רב יותר מאשר בקטגוריות אחרות, אבל אפשר לטפל בדברים האלה תוך כדי עבודה. מכיוון שכבר יש תיעוד כלשהו ואני כותב עליו, אשקול לבצע הגהה אחרי שתסתיים המשימה של כל שבוע, כי לא כדאי לעזוב אותה לשבוע האחרון.
לכן, בהמשך מופיע לוח זמנים גס לארגון הפרויקט במסגרת מגבלות הזמן.
- שבוע 1:(14 בספטמבר) • מסד נתונים
- שבוע 2:(21 בספטמבר) • תאריך ושעה
- שבוע 3:(28 בספטמבר) • פיננסי
- שבוע 4:(05 אוקטובר) • מידע
- שבוע 5:(12 אוקטובר) • לוגי
- שבוע 6:(19 אוקטובר) • מתמטיקה
- שבוע 7:(26 באוקטובר) • מערך
- שבוע 8:(2 בנובמבר) • סטטיסטי
- שבוע 9:(9 בנובמבר) • גיליון אלקטרוני
- שבוע 10:(16 בנובמבר) • טקסט
- שבוע 11:(23 בנובמבר) • תוסף
- שבוע 12:(30 בנובמבר עד 5 בדצמבר)(הגמר)
תיעוד העבודה שהתבצעה והניסיון שהושג מהפרויקט הזה ועבודה על נושאים קטינים כללו את ההגהה/עריכה של השלב השני במידת הצורך כדי להכין את המסמכים להגשה.