تقرير دراسة حالة لعام 2021

المرحلة الحالية:
انتهى برنامج "موسم المستندات" لعام 2021 في 14 كانون الأول (ديسمبر) 2021. اطّلِع على المخطط الزمني.

ملاحظة: يلخّص هذا التقرير البيانات الواردة من طلبات الانضمام إلى البرنامج الأصلية ودراسات الحالة النهائية للمؤسسات. يمكن الوصول إلى دراسات الحالة الكاملة من صفحة نتائج "موسم التوثيق التقني" لعام 2021.

لمحة عن Season of Docs

Season of Docs هو برنامج استدامة يديره مكتب برامج Google المفتوحة المصدر. تشمل أهداف "موسم التوثيق التقني" ما يلي:

• تقديم الدعم لمشاريع المصدر المفتوح لحلّ مشاكل المشاريع باستخدام الوثائق
• منح الكتاب الفنيين فرصًا لاكتساب خبرة في البرامج مفتوحة المصدر
• زيادة الوعي بالبرامج المفتوحة المصدر والمستندات والكتابة الفنية
• جمع معلومات عن المقاييس الفعّالة ومشاركتها في مستندات البرامج المفتوحة المصدر

يمكنك الاطّلاع على مزيد من المعلومات حول "موسم المستندات" على الموقع الإلكتروني الخاص بالبرنامج.

نظرة عامة على البرنامج لعام 2021

التغييرات في البرنامج لعام 2021

في عامَي 2019 و2020، قدّمت المؤسسات والكتاب الفنيون طلبات منفصلة للانضمام إلى برنامج "موسم المستندات"، وقام مشرِفو البرنامج باختيار الكتاب الفنيين المناسبين للمؤسسات. ووفّرت المؤسسات مرشدين للعمل مع الكتاب التقنيين الذين تلقّوا مكافأة مقابل عملهم استنادًا إلى موقعهم الجغرافي. وقد قيّم البرنامج مدى رضا الكُتاب الفنيين والمرشدين ومشرفي المؤسسات عن مشاركتهم في البرنامج، ولكنّه لم يقِّم نتائج إعداد المستندات.

في عام 2021، أجرى فريق Season of Docs تغييرات مهمة على البرنامج، حيث حوّل تركيزه إلى قياس نتائج التوثيق ومنح المؤسسات والكتّاب التقنيين المزيد من المرونة.

• المؤسسات التي قدّمت عروض مشاريع، بما في ذلك ميزانية ومقاييس مقترَحة
• لم يعُد بإمكان الكتاب التقنيين تقديم طلبات من خلال Google لمطابقتهم مع المؤسسات، بل أصبح بإمكانهم تقديم الطلبات مباشرةً إلى المؤسسات المقبولة.
• تلقّت المؤسسات المقبولة مِنحًا عبر خدمة Open Collective التي كانت تُستخدم للدفع للكتّاب التقنيين.
• حدّدت المؤسسات تعويضات الكتاب التقنيين.
• أرسلت المؤسسات تقييمات نهائية ودراسات حالة وأجابت عن استبيانات متابعة.

النتائج العامة لعام 2021

المؤسسات

• أدّت التغييرات في برنامج 2021 إلى انخفاض عدد المؤسسات التي تقدمت بطلبات (شهدنا انخفاضًا في عدد المؤسسات التي تقدمت بطلبات بنسبة% 30 في عام 2021 مقارنةً بعام 2020)، ولكن كان مستوى رضا مشرفي المؤسسات في عام 2021 أعلى قليلاً عن مستوى رضا مشرفي المؤسسات في عام 2020 (%93 مقارنةً بـ %91).

المشاكل وأنواع المستندات والمقاييس

• ركّزت معظم المشاريع على إنشاء مستندات لتخفيف عبء المشرف (من خلال تقليل المشاكل/الأسئلة) و/أو زيادة المشاركة في المشروع (إما من خلال مستخدمي المشروع أو المساهمين).
  • أنشأت% 50 من المؤسسات المقبولة محتوى تعليميًا أو إرشاديًا.
  • اعتبر أكثر من% 50 من المؤسسات المقبولة أنّ مستنداتها الحالية غير كافية أو غير منظمة أو قديمة.
• أرادت المشاريع بشكل عام قياس مدى فعالية مستنداتها من خلال التفاعلات، لا سيما تقليل المشاكل التي يتم طرحها وزيادة عدد الزوّار إلى المستندات والمشاركة في المشاريع.
• اعتبارًا من تشرين الثاني (نوفمبر) 2022، استجاب 25 مشروعًا من أصل 30 مشروعًا:
  • 18 مشروعًا أفادت أنّها حققت المقاييس الأصلية
  • استيفاء 5 مشاريع للمقاييس المعدَّلة
  • أشارت مشاريعان إلى أنّه لا يزال من المبكر جدًا تحديد ذلك.

المشاركة في البرنامج

• كان تعيين الكتّاب التقنيين ودفع رواتبهم هو الجزء الأكثر صعوبة في البرنامج بالنسبة إلى مشرفي المؤسسات.
• اعتبارًا من تشرين الثاني (نوفمبر) 2022، استجابت 24 مؤسسة من أصل 30 مؤسسة:
  • استمرّت 18 مؤسسة في العمل مع الكتاب الفنيين المشاركين في "موسم كتابة المستندات" (إما كمشاركين مستمرين أو كمرجع للإجابة عن الأسئلة).
    • 4 مؤسسات كانت تعمل مع الكتاب الفنيين في "موسم كتابة المستندات" في دور مدفوع

أبرز الأحداث في 2021

• أشارت مشاريع متعدّدة إلى أنّ الكاتب التقني كان ينوي مواصلة العمل على مشروعه بعد انتهاء برنامج "موسم المستندات".
• تلقّت شركة Metanorma العديد من طلبات الالتحاق من المؤهّلين من الكُتّاب التقنيين، ما ساعدها في العثور على أموال متطابقة لتوظيف كاتب إضافي للعمل مع الكاتب المستفيد من برنامج "موسم استخدام مستندات Google" خلال البرنامج.
• وجدت Moja Global أن المجتمع كان متفاعلاً بشكل كبير مع التوثيق وقام بإنشاء مجموعة عمل جديدة للتوثيق للسماح لمزيد من المساهمين بالمشاركة في وثائق المشروع

بيانات الملخّص لعام 2021

في عام 2021، قدّمت 82 مؤسسة طلبًا للانضمام إلى البرنامج ووافقت 30 مؤسسة مفتوحة المصدر على البرنامج. (يُرجى الاطّلاع على دليل إنشاء تطبيقك لمعرفة معايير الاختيار). يمكنك الاطّلاع على القائمة الكاملة للمؤسسات المشاركة على موقع "موسم المستندات" الإلكتروني. أرسلت جميع المؤسسات الثلاثين المقبولة تقرير دراسة الحالة النهائي لإكمال مشاركتها في برنامج 2021.

لمحة عن المؤسسات

مثّلت المؤسسات المشاركة في "موسم المستندات لعام 2021" مجموعة متنوعة من مشاريع البرامج المفتوحة المصدر. تشمل مجموعة 2021 النموذجية ما يلي:

• المشاريع اللغوية الكبيرة مثل Julia وPerl وR
• المشاريع في التعليم والمناخ والتكنولوجيا المالية والرعاية الصحية وخدمات المكتبات والتعلم الآلي والقياس الطيفي الجماعي والعقود العامة وعلم الروبوتات
• المشاريع التي تركّز على المطوّرين، بما في ذلك أدوات هندسة الفوضى وأدوات البحث عن الأخطاء وأدوات تطوير برامج الدردشة الآلية وعمليات تحليل تركيب البرامج وأدوات مراقبة الأداء وأدوات البرمجة المرئية
• مشاريع إعداد المستندات لأدوات إعداد المستندات، مثل Redocly وMetanorma

كانت مشاريع منظومة Python المتكاملة هي الفئة الفرعية الأكبر. ضمّت مجموعة 2021 ArviZ وNumPy وMicroPython وPyMC3 وPyTorch-Ignite وSymPy.

لم نجمّع أي بيانات وصفية عن المشاريع (مثل تاريخ التأسيس أو التوزيع الجغرافي للمساهمين أو عدد المساهمين أو حجم قاعدة المستخدمين).

لقد طلبنا من المشاريع الإشارة إلى ترخيص المصدر المفتوح الذي استخدمته.

إنّ مشاكل المستندات التي حدّدتها المؤسسات في عام 2021 هي مشاكل شائعة جدًا في كلّ من المشاريع مفتوحة المصدر والمستندات الفنية بشكل عام.

تشمل أهمّ المشاكل التي كانت المؤسسات تأمل في حلّها في برنامج 2021 ما يلي:

يُرجى العِلم أنّه يمكن للمؤسسات الإبلاغ عن مشاكل متعددة في المستندات. لمزيد من التفاصيل، يُرجى الاطّلاع على صفحة النتائج في موسم المستندات لعام 2021، والتي تتضمّن روابط إلى دراسات حالة كاملة لكل مؤسسة.

أنواع المستندات التي تم إنشاؤها

كانت الأدلة الإرشادية هي نوع الوثائق الأكثر ذكرًا في دراسات الحالة لعام 2021.

تشمل أنواع المستندات الأخرى المذكورة في دراسات الحالة مسار المستندات بصفتها رمزًا، والمخطّط البياني، والمسرد، ودليل الأنماط، والأسئلة الشائعة، والتعريب، وCodelab، ونموذج المحتوى، والوحدات، ومستندات المفاهيم، ورسائل الخطأ، وأبحاث المستخدمين، وملف Readme، وقاعدة المعلومات.

بعض هذه الفئات غير واضحة، ويمكن أن يحتوي مشروع مستندات واحد على أنواع أو ميزات متعددة من الوثائق.

تمّت الإشارة إلى العديد من المشاريع على وجه التحديد باستخدام إطار عمل Diátaxis كدليل لتخطيط أنواع مستنداتها.

لمزيد من التفاصيل، يُرجى الاطّلاع على صفحة النتائج الخاصة بموسم "مستندات Google" لعام 2021، والتي تتضمّن روابط تؤدي إلى دراسات حالة كاملة لكل مؤسسة.

الميزانيات

في عام 2021، بلغ متوسّط طلب الميزانية 10,200 دولار أمريكي (أو ما يعادله بالعملة المحلّية)، وكان المتوسط 10,000 دولار أمريكي. لم تطلب سوى ثلاث منظمات وتلقّت أكبر منحة ممكنة (15 ألف دولار)، بينما طلبت ثلاث مؤسسات أخرى أقل منحة ممكنة (5 آلاف دولار).

المقاييس

مشاريع مُوضَّحة في دراسات الحالة للمقاييس التي كانت تستخدِمها لقياس نجاح مشاريع التوثيق

في ما يلي أهم المقاييس المقترَحة:

وتشمل المقاييس المقترَحة الأخرى النجوم على GitHub، والوقت الذي يقضيه المستخدمون على الصفحة، والإحالات الناجحة من القائمة البريدية، واختبار المستخدمين النوعي، وعدد المشاركين في المنتديات، وعدد الشركاء/المتطوّعين/عمليات الدمج.

نظرًا للنافذة القصيرة بين إنهاء مشاريع الكتابة الفنية وتقديم دراسات الحالة، لم تتمكن معظم المجموعة النموذجية لعام 2021 من جمع بيانات كافية لتحديد ما إذا كان قد تم استيفاء المقاييس الأولية أم لا.

لمزيد من التفاصيل، يُرجى الاطّلاع على صفحة النتائج الخاصة بموسم "مستندات Google" لعام 2021، والتي تتضمّن روابط تؤدي إلى دراسات حالة كاملة لكل مؤسسة.

العمل مع الكتاب الفنيين

إنّ التغيير الأكبر الذي شهده برنامج Season of Docs في عام 2021 هو أسلوب عمل المشاريع مع الكُتّاب التقنيين. في المواسم السابقة، كان الكتاب الفنيون يتقدمون بطلبات إلى Google مباشرةً، وكان المشرفون على البرنامج يختارون المشاريع المناسبة لهم، وكانوا يتلقّون مكافأة ثابتة من Google مباشرةً.

في عام 2021، قدّم الكتاب الفنيون طلبات للانضمام إلى المشاريع مباشرةً، وحدّدت المشاريع الميزانية لتعويضهم، وتم إجراء الدفعات من خلال صندوق Open Collective في "موسم مستندات Google".

لم تكن معظم المشاريع المشاركة في برنامج 2021 لديها خبرة قليلة أو معدومة في تعيين أو استئجار كتاب تقنيين، ولفتت العديد من المشاريع إلى أنّ هذا الجزء من العملية يحتاج إلى مزيد من الدعم. استجابةً لهذه الملاحظات، أضاف فريق "موسم المستندات" مستندات لإنشاء اتفاقيات مع الكتاب الفنيين إلى دليل البرنامج.

اقتراحات التوظيف

وطُلب من المشاريع تقديم توصيات لمشاريع أخرى مهتمة بالمشاركة في "موسم المستندات" (Season of Docs). في ما يلي أهم اقتراحات التوظيف:

• شارِك مواد التجنيد المخصّصة للكاتبِين التقنيِين في أقرب وقت ممكن، حتى قبل قبولك في البرنامج. اطلب من أفراد المنتدى إحالة المرشحين المحتملين.
• مشاركة المحتوى على نطاق واسع خارج قنوات المشروع استخدِم لغة شاملة وشجِّع بشكل مباشر المرشّحين من الفئات التي لا تحظى بالتمثيل الصحيح على تقديم الطلبات.
• عليك معرفة الأدوات الأساسية لعملية إنشاء المستندات وتعيين كتاب تقنيين لديهم خبرة في استخدام هذه الأدوات.
• حدِّد توقعات واضحة للكاتب الفني بشأن التسليمات والمحطّات الرئيسية وقنوات التواصل وعمليات التحقّق وعمليات الدفع وتوقيتها.
• يمكنك التفكير في الاستثمار في أعضاء المنتدى ومساعدتهم على النمو ككتّاب تقنيين من خلال استخدام الكاتب التقني لـ Season of Docs لتوفير الإرشاد والتدريب.
• خصِّص وقتًا أطول مما تتوقّع لتدريب الكتاب الفنيين والإجابة عن الأسئلة وتقديم الدعم أثناء البرنامج، خاصةً إذا لم يكن لدى الكاتب الفني خبرة سابقة في مجال مشروعك.
• سجِّل عملية التوظيف والتعاقد والإعداد لاستخدامها في المشاريع المستقبلية.

(ملاحظة: لم يتمّ الإشارة في دراسات الحالة إلى جميع المشاريع التي تمّ فيها تعيين مرشّحي الكتابة الفنية).

المشاكل الشائعة في العمل مع الكتاب الفنيين

اضطر الكتاب الفنيون في العديد من المشاريع إلى الانسحاب بسبب الإصابة بفيروس كورونا أو أمراض أخرى، أو بسبب المسؤوليات العائلية المرتبطة بالوباء. أبلغت بعض المشاريع عن مشاكل في الاتصالات تتعلق بعدم تطابق المنطقة الزمنية أو مشاكل في الاتصال بالإنترنت.

وجدت المشاريع أنّها قللت من تقدير الصعوبات التي ينطوي عليها الالتحاق بمجتمعاتها أو في إعداد سلسلة أدوات المستندات الخاصة بمشاريعها.

شهدت بعض المشاريع تأخيرات في دفع رسوم الكتاب التقنيين بسبب مشاكل مصرفية في Open Collective أو بسبب فرض قيود على الدفع في بلدان الكتاب الأصلية.

لم تكن مستندات البرنامج حول رسوم Open Collective واضحة: كانت Google تغطّي رسوم المعاملات في Open Collective للتحويل الأولي للأموال إلى المشاريع، ولكن ليس رسوم المعاملات التي تفرضها بعض قنوات الدفع الأخرى (مثل رسوم تحويل العملة). وسنعمل على توضيح ذلك بشكل أفضل في مستندات البرامج المستقبلية.

الاستطلاعات اللاحقة

كجزء من برنامج "موسم المستندات"، طُلب من المشاريع المشاركة في استطلاعات المتابعة. تم إرسال ثلاثة استطلاعات في أيار (مايو) وأغسطس (آب) وتشرين الثاني (نوفمبر) 2022.

طلب استطلاع المتابعة من المشاريع تأكيد أنّ روابط الاقتراح ودراسة الحالة لا تزال نشطة. كما تضمن الاستبيان أيضًا أسئلة حول نجاح مشروعاتهم (على النحو الذي يحدده المقاييس التي حددوها في دراسة الحالة الخاصة بهم) والمشاركة المستمرة وتعويض الكتّاب التقنيين للمشروع:

1. هل ما زلت تعمل مع الكاتب الفني الذي تم تعيينه لك في "موسم المستندات"؟

1. إذا كان الكاتب التقني لا يزال يعمل على مشروعك، هل يتم تعويضه بأي شكل من الأشكال؟

1. في هذه المرحلة، هل تعتقد أنّ مشروع التوثيق ناجح؟

أسئلة مستقبلية

كالعادة، كلما زادت معرفتنا بالمستندات في البرامج المفتوحة المصدر، زادت رغبتنا في التعلم. في المواسم المستقبلية، نأمل أن نعرف:

• ما إذا كانت مجالات المشروع مرتبطة باختيار نوع المستند أو اختيار المقياس
• أفضل ممارسات توظيف الكتاب التقنيين وإعدادهم لإنجاز المشاريع والاحتفاظ بهم
• جداول زمنية معقولة لقياس فعالية التوثيق

على الرغم من وجود العديد من الأسئلة التي نرغب في التحقيق فيها، إلا أننا نريد أيضًا احترام وقت مشرفي المشروع مفتوح المصدر والقائمين على الصيانة الذين يشاركون في موسم المستندات. إنّ أهم أولويات البرنامج هي مساعدة المشاريع في حلّ مشاكلها المتعلّقة بالوثائق.