تحتوي هذه الصفحة على تفاصيل مشروع كتابة تقنيّة تم قبوله في موسم المستندات من Google.
ملخص المشروع
- المؤسسة المفتوحة المصدر:
- مؤسسة Data Commons
- الكاتب التقني:
- KilimAnnejaro
- اسم المشروع:
- تحسين مستندات بدء استخدام DataCommons
- مدة المشروع:
- المدة العادية (3 أشهر)
وصف المشروع
خلال مسيرتي المهنية كمهندس برمجيات، وجدت نفسي محبطًا بشكل متكرر بسبب تجربة الانضمام إلى فريق أو مشروع جديد، وسحب مستودع التعليمات البرمجية، وتشغيله، ومشاهدة تعطل البرنامج عندما تكون الخطوات الرئيسية مفقودة من الوثائق. وسرعان ما أدركت أنّه يمكنني تطبيق شغفي الدائم للكتابة والإنشاء على هذه الاحتياجات من خلال عملية خلق بيئة داعمة للمطوّرين الذين عملت معهم للتركيز على الابتكار التقني والإبداع، بدلاً من حل المشاكل باستخدام الإجابات المعروفة.
وهناك حاجة ماسة إلى هذا الابتكار التقني والإبداع في العديد من شرائح المجتمع، وخاصةً من قِبل القادة في الحكومة والقطاع غير الربحي الذين يسعون إلى تحليل مجموعات البيانات في مساحاتهم المتعلقة بالمشكلات. من خلال جعل هذه البيانات متاحة بسهولة كخدمة، تقلل DataCommons من الحاجز أمام الدخول للمحللين الذين يبحثون عن البيانات التي يسهل الوصول إليها وقريبة من التنسيق الذي يحتاجون إليه لأدوارهم. ويقوم DataCommons بذلك عن طريق إنشاء رسم بياني معرفي للبيانات التي يستوعبها، في العملية التي تثير أسئلة مثيرة للاهتمام حول جودة البيانات وحوكمة البيانات في سياق البرامج المفتوحة المصدر. من خلال تقديم طلب للانضمام إلى برنامج Summer of Docs من Google مع اقتراح لمؤسسة DataCommons، آمل في دعم هذه الجهود الفنية وتطويرها في مجال البيانات المفتوحة للمصلحة العامة.
الشكاوى الحالية في الوثائق مع الحلول المقترحة في حين أن موقع dataCommons يحتوي على توجيهات لإضافة مجموعات البيانات إلى dataCommons، فإن التوجيهات قصيرة جدًا وغير واضحة، وتتكون من عدة نقاط تعداد توجه المتبرع المحتمل بالبيانات لاستخدام ترميز schema.org. كجزء من هذا المشروع، أقترح تنظيف قسم "الاشتراك" في dataCommons.org. سأُنشئ برنامجًا تعليميًا لإضافة مجموعات بيانات جديدة، يوضّح كيفية سرقة مجموعات البيانات ودمجها في الرسم البياني المعرفي لـ dataCommons. سأضيف أيضًا قسم الأسئلة الشائعة للحلول الشائعة المقترحة عندما يتواصل مالك مجموعة البيانات مع مشرفي dataCommons للحصول على المساعدة.
باستعراض المجموعة الحالية من الأمثلة للاستعلام عن البيانات، تقدم dataCommons فقط أربعة أمثلة على التعليمات البرمجية التفاعلية، جميعها دفاتر ملاحظات بايثون. كجزء من هذا المشروع، سأترجم هذه الدفاتر إلى لغة R وأقوم أيضًا بإنشاء إصدارات تجريبية تفاعلية من الأمثلة الحالية لجداول بيانات Google وواجهة برمجة تطبيقات REST، مع تضمين هذه العروض التوضيحية في الوثائق الحالية.
وأخيرًا، لا تقدم الوثائق حقًا أي أمثلة حول كيفية استخدام الرسم البياني المعرفي لـ dataCommons لإنشاء تطبيقات في البرامج. وكجزء من هذا المشروع، سأُنشئ نموذجًا وأنشره وأوثِقه في أداة في بايثون تستخدم واجهة برمجة التطبيقات dataCommons لتمكين المستخدم النهائي من إنشاء تصورات رسومية تتعلق بأي كميتين مرتبطتين في الرسم البياني المعرفي. فعلى سبيل المثال، قد يتمكن أحد الأشخاص من استخدام هذه الأداة لرسم انحدار خطي يربط بيانات الطقس بمعلومات أنماط الأعمال الشائعة. كهدف توسيعي، آمل أن أوسع هذه الأداة لتشمل أنواعًا أخرى من التصورات، مثل المخططات الدائرية ومخططات Venn.
الجدول الزمني يبدأ الموسم من 14 سبتمبر إلى 30 نوفمبر، لذا تبدو خطتي لإكمال هذا المشروع كما يلي:
سبتمبر: ابدأ بإعادة كتابة قسم "Get Involved" (الحصول على المشاركة)، حيث ينهي هذا العمل غالبًا بحلول نهاية سبتمبر.
تشرين الأول (أكتوبر): لخّص قسم "الاشتراك" وأنشئ نماذج التعليمات البرمجية التفاعلية.
نوفمبر: قم بإنشاء أداة تصور العينة.