كجزء من التقييم النهائي، على جميع المساهمين المشاركين توفير رابط للعمل الذي أنجزوه من أجل البرنامج. قد يؤدي عدم القيام بذلك بشكل صحيح إلى فشل البرنامج. هناك عدة طرق مختلفة للقيام بذلك، لذا يُرجى قراءة هذا المستند بعناية.
سيتم نشر هذه الروابط على الأرشيف العام لمشاريع GSoC. تساعد في توضيح العمل الذي تم إجراؤه أثناء البرنامج. إنها أيضًا طريقة رائعة بالنسبة لك للرجوع إلى عملك لأصحاب العمل في المستقبل. فأنت تريد أن يتمكن الأشخاص من فهم أهداف مشروعك بسرعة، وما أنجزته، وأين توجد التعليمات البرمجية الخاصة بك، وأي خطوات تالية محتملة.
أفضل الأمثلة التي رأيناها في السنوات الماضية تبدو مثل "تقرير نهائي" يحتوي على:
- وصف موجز لأهداف المشروع.
- ما فعلته.
- الحالة الحالية.
- الإجراءات المتبقية.
- الرمز الذي تم دمجه (أو عدم دمجه) في مرحلة البث
- أي تحديات أو أشياء مهمة تعلمتها أثناء المشروع.
للاطّلاع على أمثلة، ابدأ من قائمة المشاريع لعام 2022، واختَر المشاريع عشوائيًا، ثم انقر على "عرض الرمز". يرجى ملاحظة أن العديد من هذه المشروعات لم تتبع اقتراحاتنا، مما يعني يضر بها فقط في القدرة على التباهي بعملها.
ملاحظة للمساهم: بعد إرسال العمل النهائي، يمكنك تعديله حتى الموعد النهائي لإرسال عملك النهائي.
يجب عليك مشاركة الرابط الخاص بك مع مرشدك قبل إرسال تقييمك للتأكد من أنه يلبي توقعاته.
المتطلّبات
- يجب أن يكون من السهل تحديد العمل الذي أنجزته. (أي التغييرات التي أجريتها أو
التعليمات البرمجية الجديدة).
- عندما ينتقل شخص ما إلى عنوان URL المقدَّم، يجب أن يكون واضحًا لك العمل الذي أنجزته بدون مطالبته بإجراء عمليات بحث إضافية مهمة.
- يجب أن يكون في مكان ثابت. لا يمكن تغيير عنوان URL بعد الإرسال.
- من المفترض أن يتمكّن شخص آخر من استخدام المحتوى في هدف الرابط (أو يُشار إليه منه) لتوسيع نطاق عملك.
- إذا اكتمل عملك بنسبة 100٪، فمن المفترض أن يكونوا قادرين على استخدامه.
- إذا لم يكتمل عملك بنسبة 100٪، فيجب أن يكون واضحًا ما المتبقي للقيام به.
أمثلة على إعلانات جيدة
ليس عليك القيام بكل (أو أي) من هذه الأشياء، ولكن هذه بعض الطرق التي يمكنك من خلالها تلبية المتطلبات.
- أنشئ منشور مدونة أو صفحة ويب أو عنصر GitHub عام يصف العمل
الذي أنجزته ويربط بالالتزامات التي أنجزتها والمستودعات التي عملت عليها. إذا كان لا يزال هناك عمل يجب القيام به في المشروع،
فقم بتضمين ذلك أيضًا. ويمكنك أيضًا مشاركة لحظات مميزة أو مليئة بالتحديات.
- ❗ هو أفضل خيار لأنه يسمح لك بتضمين الكثير من المعلومات بسهولة. هذا أمر جيد لأنه سيُظهر بوضوح العمل الذي قمت به، بالإضافة إلى تسهيل استخدام الآخرين وفهم التعليمات البرمجية الخاصة بك.
- إذا كنت تستخدم GitHub، وكان كل عملك مغطى بطلب سحب واحد،
فيمكنك استخدام هذا الرابط.
- تأكَّد من أنّ وصف طلب السحب مفصل. (اطّلع على الاقتراحات لمحتوى مشاركات المدونة أعلاه.)
- احرص على أن يشير الوصف بوضوح إلى أنّ هذا الطلب مخصّص لفعالية Google Summer of Code.
- إذا كان طلب السحب سيُنجز المزيد من العمل بعد انتهاء GSoC، تأكَّد من تدوين التزام GSoC الأخير.
- ❗ هذا المثال له فائدة توفير سجل التغيير وقائمة الالتزامات وتعليقات المراجعة كلها في مكان واحد.
- إذا كان مستودع جيت هب لديك غرضًا واحدًا من أجل GSoC، أضِف README.md بمزيد من التفاصيل.
- أرسل رسالة إلكترونية إلى القائمة البريدية لمطوّري البرامج الذين تمت أرشفتها بشكل علني، المذكور فيها أعلاه، وأضِف رابطًا يؤدي إليها أيضًا.
- أنشئ مجلدًا عامًا في Google Drive وضمِّن جميع رموز التصحيح التي أنشأتها.
- أنشئ جدول بيانات عامًا باستخدام "جداول بيانات Google" واذكر جميع التزاماتك.
- قم بربط خطأ واحد يحتوي بوضوح على إشارات إلى العمل وأي شيء آخر مناسب. يجب أن يتتبع كل العمل الذي أنجزته. تأكد من أنه يسرد جميع التعهدات أو يسهل العثور عليها.
- أدرِج رابطًا يؤدي إلى اختلاف موحد أو سياق بين تغييراتك. تأكد من تضمين عنوان يشير إلى المشروع الذي يستهدفه ومن أنت، حتى يكون مفيدًا للآخرين.
أمثلة على أحجام النص السيئة
لا تفعل هذه الأشياء.
- رابط إلى tarball/zipfile يحتوي على كود المصدر للمشروع بأكمله أو دليل العمل. (لقد فعل الكثير من الأشخاص هذا من قبل، وليس من المفيد للأشخاص الذين يريدون معرفة المزيد حول ما فعلته أنت).
- الربط بالجزء العلوي من مستودع المصدر الأساسي للمشروع.
- مثلاً، إذا كنت تعمل على لغة cpython، لن يكون هذا الرابط مفيدًا: https://github.com/python/cpython
- أدرِج رابطًا إلى مستودع المصدر الخاص بالمشروع واستنساخه.
- يجعل هذا من الصعب رؤية التغييرات التي أجريتها لأن عملك مختلط مع الآخرين.
- رابط إلى صفحة مشروع GSoC
- نحن نعلم بالفعل ما هو. (أي
https://summerofcode.withgoogle.com/projects/#1234567890)
- نحن نعلم بالفعل ما هو. (أي
الموجّهون
يُرجى مساعدة المساهم في إرسال الرمز بشكل صحيح. من المهم القيام بذلك قبل فترة إرسال العمل النهائي.
تحقق من ذلك...
- تستوفي العينة التي تم إرسالها المتطلبات أعلاه.
- يتم تجميع التعليمة البرمجية.
- هناك وثائق عن ماذا ولماذا.
فكرة GSoC ليست أنّ المساهمين يوقفون استخدام الرموز البرمجية -- من المهم أن يكون الرمز البرمجي مفيدًا إلى المشروع الذي يستضيف البرامج المفتوحة المصدر.