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