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