تحتوي هذه الصفحة على تفاصيل مشروع كتابة فنية تم قبوله في "موسم مستندات Google".
ملخّص المشروع
- مؤسسة مفتوحة المصدر:
- لغة Julia
- الكاتب الفني:
- mkg33
- اسم المشروع:
- المستندات المُوحَّدة لتعلُّم الآلة العلمي
- مدة المشروع:
- مدّة طويلة (5 أشهر)
وصف المشروع
أودّ العمل على توحيد مؤسسة SciML لأنّ هناك مجالًا كبيرًا للتحسين في هذا المجال، وسيؤدي إكمال هذا المشروع بلا شك إلى تحقيق مزايا فورية لكل من مبرمجي Julia والمساهمين/المشرفين النشطين في SciML. توفّر الحِزم المنتشرة في SciML بعض الأدوات المفيدة حقًا، ولكن هناك خطر دائم بأن لا يتم ملاحظتها (خاصةً من قِبل الوافدين الجدد) لمجرد أنّ المستخدم لم يتمكّن من اكتشاف الحزمة وتطبيقها على المشكلة المطروحة.
هذا أمر محبط إلى حدٍ ما، لأنّ الغرض الأساسي من الحِزم هو الوصول إلى جمهور واسع من المبرمجين (المبتدئين والخبراء على حد سواء). لتجنّب الموقف الموضّح أعلاه، نقترح مراجعة "الصفحة الرئيسية" لمستندات SciML بدقة وإنشاء نوع من المحور الذي يمكن للمستخدمين استخدامه لتصفّح الحِزم ذات الصلة واستكشاف المنظومة المتكاملة المتنامية. ويمكن أن يكون أيضًا مرجعًا قيّمًا للمستخدمين الأكثر خبرة ويسمح لهم بالعمل بكفاءة أكبر.
أولاً، يجب مراجعة المستندات الحالية لجميع الحِزم الفردية في ما يتعلق بالمشاكل الأساسية المتعلقة بالأسلوب (مثل التهجئة وعلامات الترقيم والقواعد النحوية وما إلى ذلك). لضمان اتّساق الأسلوب، يجب أن يتضمّن SciML دليل أسلوب محدّدًا (وهو أمر لا غنى عنه لإجراء تغييرات بأثر رجعي وللرجوع إليه في المستقبل). سيكون من قبيل إضاعة الوقت البدء من الصفر. بدلاً من ذلك، يجب أن يستند إلى اصطلاحات Julia الحالية وأن يتضمّن إدخالات جديدة للمشاكل المتعلّقة بـ SciML.
بعد الانتهاء من دليل الأنماط، أخطّط لمراجعة المستندات الحالية في المرحلة الثانية من المشروع. سيجعل ذلك المستندات تبدو أكثر احترافية وثباتًا. لقد قمت بالفعل بإنشاء العديد من طلبات السحب التي توضح نهجي في هذه المهمة. في هذه المرحلة، أهدف أيضًا إلى وضع نظام فعّال للاستشهادات (وتنفيذه). ستكون المهمة الأولى هي تعديل صفحة الإحالات القديمة.
ستتضمّن المرحلة الثالثة، التي يُحتمل أن تكون الأكثر أهمية، تصميم خارطة طريق SciML التي ستُبرز التفاعل بين الحِزم المتفرقة. كلما كان الترابط الأقوى بين حزمتين (في ما يتعلق بالمشكلة أو التعليمة البرمجية نفسها)، كلما اقتربت من ظهورها في القائمة "راجع أيضًا". نقترح إنشاء مفتاحَي اقتراح: أحدهما للتشابه في الرموز البرمجية والآخر للتشابه في المشاكل. بهذه الطريقة، سيتمكن المستخدمون من تحديد الحزم الأخرى التي يحتمل أن تكون مفيدة بشكل أسرع بكثير من التصفح الشاق عبر المستودعات والوثائق ذات الصلة. بدلاً من سرد جميع الاتصالات الممكنة بين الحزم، أفضّل التركيز على الروابط الأكبر ومحاولة تقديم روابطها بحزم أصغر (ستمتد هذه الطريقة أيضًا إلى تحديث البرامج التعليمية حيث يجب الإشارة إلى الاتصال بحزمة أخرى). يضمن هذا المنهج أن تكون قوائم "انظر أيضًا" مفيدة بدون أن تكون عمليات إحصاء شاملة لمجموعات الحِزم.