تحتوي هذه الصفحة على تفاصيل مشروع كتابة فنية تم قبوله في "موسم مستندات Google".
ملخص المشروع
- مؤسسة مفتوحة المصدر:
- LibreOffice
- الكاتب الفني:
- Krezhairo
- اسم المشروع:
- Calc Functions Reference and User Guide (مرجع دوال Calc ودليل المستخدم)
- مدة المشروع:
- المدة العادية (3 أشهر)
وصف المشروع
طلب المشروع
يمكنني بسهولة تخصيص 30 إلى 35 ساعة في الأسبوع خلال مرحلة الكتابة الفنية و10 إلى 12 ساعة في مرحلة ما قبل الكتابة لتعلم أي مهارة إضافية مطلوبة للمشروع. أريد إعلامك بأنّني أقيم حاليًا في جامعتي(في بلدي الأصلي) حيث يتوفّر لي اتصال بالإنترنت السريع وأيّ موارد إضافية مطلوبة للمشروع، وسأواصل العمل من جامعتي طوال مدة المشروع لأنّنا في ظلّ جائحة COVID-19 لا نرى أنّ جامعتي ستبدأ الدراسة في أي وقت قريب، وحتى لو بدأت، سأكون في السنة النهائية حيث من المفترض أن أحضر الصفوف لمدة تتراوح بين 5 و6 ساعات في الأسبوع فقط، وبالتالي لن يؤثر ذلك في المشروع بأي شكل من الأشكال.
مقدمة
يحتوي LibreOffice Calc على قائمة واسعة (أكثر من 500) بالدوالّ في العديد من الفئات التي تكون فيها الوثائق سطحية جدًا (ولكن دقيقة مع ذلك) في المساعدة. كما يوفر معالج الدوال المدمج في حساب المستخدم معلومات موجزة حول الغرض من كل دالة ومعلماتها. تم إنشاء بنية في موسوعة The Document Foundation على الإنترنت لتسجيل معلومات مرجعية أكثر تفصيلاً حول دوالّ Calc.
الهدف
لملء بنية الموسوعة على الإنترنت من خلال كتابة محتوى أكثر تفصيلاً لكل دالة من دوال 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، بما في ذلك الرسوم التوضيحية والرسوم البيانية كلما أمكن ذلك، وتقديم مثال أو مثالَين للإشارة إلى الحالات الشاذة والاستثناءات في شكل ملاحظات، وتقديم نماذج من الملفات. إضافة قسم مهم أيضًا في أي مكان يكون مفيدًا سأحاول الاطّلاع على هذه الدوالّ بتنسيق تصنيفي، أي اختيار واحدة والعمل عليها عموديًا ثم الانتقال إلى فئة أخرى خلال فترة الكتابة الفنية. بالإضافة إلى ذلك، ننصحك بالتعود على بيئة العمل خلال فترة الاندماج في المنتدى لتسهيل الأمور خلال مرحلة الكتابة. من واقع خبرتي، فإن اكتشاف كل لحظات "الخطأ" الصغيرة العديدة لتوثيق هذه الأنواع من التطبيقات يتطلب استثمارًا للوقت. من ناحية التخطيط، سأبدأ المشروع من خلال الاطّلاع على هذه الفئات الإحدى عشرة للعمل عليها، وبالطبع، ستحتاج بعض الفئات إلى مزيد من المساعدة وبالتالي ستستغرق وقتًا أطول من غيرها، ولكن يمكن معالجة هذه الأمور أثناء العمل. بما أنّ هناك بعض المستندات الحالية التي أكتب عليها، سأراجعها بعد إكمال مهمة كل أسبوع لأنّه ليس من الجيد تركها للأسبوع الأخير.
في ما يلي جدول زمني تقريبي لتنظيم المشروع في حدود المدة الزمنية المحدّدة.
- الأسبوع 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 كانون الأول (ديسمبر))(النهائي)
تضمنت توثيق العمل المنجز والخبرة المكتسبة من هذا المشروع والعمل على أشياء ثانوية، تدقيق/تعديل الاجتياز الثاني إذا لزم الأمر لإعداد الوثائق للإرسال.